There are many Linux distributions in existence and we strive to support as many as possible.
|Debian||8, 9, 10|
|Ubuntu||16.04, 18,04, 19.04, 19.10|
|VoidLinux & VoidLinux-musl||Rolling|
|OpenSuSE||Leap and Tumbleweed|
|Manjaro + Manjaro-ARM||Rolling|
If you don’t see your distro in the lists bellow you have two options. Either open a ticket asking for support or if you feel adventurus follow the guide how to add support for your linux distro and also consider making a PR so the community can benefit.
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:
Download Go either using your system package manager or from the Go Downloads Page.
Ensure that you follow the official Go installation instructions.
$GOPATH/bin to the
on to the
GO111MODULE environment variables. You can do this by adding these lines to your
/etc/profile (for a system-wide installation) or
export PATH=$PATH:$GOPATH/bin export GO111MODULE=on
Note: changes made to a profile file may not apply until the next time you log into your computer. To apply the changes immediately, just run the shell commands directly or execute them from the profile using a command such as
npm either using your system package manager or from the Node Downloads Page. It is best to use the latest release as that is what we generally test against.
npm --version to verify.
For Linux, Wails uses
GTK. These need to be installed using the distribution specific commands below.
sudo apt install build-essential libgtk-3-dev libwebkit2gtk-4.0-dev
sudo pacman -S gcc pkgconf webkit2gtk gtk3
sudo yum install gcc-c++ make pkgconf-pkg-config webkitgtk3-devel gtk3-devel
sudo yum install gcc-c++ make pkgconf-pkg-config webkit2gtk3-devel gtk3-devel
xbps-install base-devel gtk+3-devel webkit2gtk-devel
sudo emerge gtk+:3 webkit-gtk
If you have successfully installed these dependencies on a different flavour of Linux, please consider clicking the “Edit this page” link at the top of the page and submit a PR.
Now you are ready to move on to the next step of installing Wails.