V1 of Wails is now in feature freeze. V2 is now in Beta for all platforms



Wails uses cgo to bind to the native rendering engines so a number of platform dependencies are needed as well as an installation of Go. The basic requirements are:

  • Go 1.12 or above
  • gcc + libraries
  • npm
  • Docker for Cross-Compilation support


Download Go from the Go Downloads Page. We recommend downloading the MSI package.

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 c:\Go\bin directory. Also ensure Go modules are enabled - You may do so through the “Environment Variables” button on the “Advanced” tab of the “System” control panel. Some versions of Windows provide this control panel through the “Advanced System Settings” option inside the “System” control panel.

Restart your terminal and do the following checks:

  • Check Go is installed corectly: go version
  • Check “c:\Go\bin” is in your PATH variable: echo %PATH%
  • If using Go 1.12 instead of 1.13, check “GO111MODULE” environment variable is set to “on”: echo %GO111MODULE%.

It is STRONGLY recommended that if you use a terminal on Windows, that you use the git bash terminal and not the VSC terminal. This is because it handles signals correctly. We have found the VSC terminal to be quite buggy.


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.

There is a known issue with NPX regarding spaces in your user profile path. If you have any issues, please consult that ticket for workarounds.

GCC + Libraries

Windows requires gcc and related tooling. The recommended download is from https://jmeubank.github.io/tdm-gcc/download/.

Wails applications on Windows use the mshtml library which is only compatible with IE11. It is STRONGLY recommended that you use IE11 to test your application using the wails serve command. For more information, please refer to our Windows Development Guide.

Now you are ready to move on to the next step of installing Wails.