Skip to main content


Supported Platforms#

  • Windows 10
  • MacOS x64 & arm64 (due October '21)
  • Linux (due December '21)


Wails has a number of common dependencies that are required before installation:

  • Go 1.17+
  • npm (Node 14+)


Download Go from the Go Downloads Page.

Ensure that you follow the official Go installation instructions. You will also need to ensure that your PATH environment variable also includes the path to your ~/go/bin directory. Restart your terminal and do the following checks:

  • Check Go is installed correctly: go version
  • Check "~/go/bin" is in your PATH variable: echo $PATH | grep go/bin


Download NPM from the Node Downloads Page. It is best to use the latest release as that is what we generally test against.

Run npm --version to verify.

Platform Specific Dependencies#

You will also need to install platform specific dependencies:

Wails requires that the WebView2 runtime is installed. Some Windows installations will already have this installed. You can check using the wails doctor command (see below).

Optional Dependencies#

  • UPX for compressing your applications.

Installing Wails#

Run go install[email protected] to install the Wails CLI.

System Check#

Running wails doctor will check if you have the correct dependencies installed. If not, it will advise on what is missing and help on how to rectify any problems.