Installation
Windows [7, 8.1, 10, 11, 2008R2, 2012R2, 2016, 2019, 2022 – v0.5.3]
Download Windows Installer
Browse MSIs
macOS [app store – v1.0.15]
Ubuntu [module – v1.0.20210606 – out of date & tools – v1.0.20210914]
$ sudo apt install wireguard
Android [play store – vunknown – out of date & f-droid – v1.0.20220516]
Download from Play Store
Download from F-Droid
iOS [app store – v1.0.15]
Debian [module – v1.0.20210606 – out of date & tools – v1.0.20210914]
# apt install wireguard
Users with Debian releases older than Bullseye should enable backports.
Fedora [tools – v1.0.20210914]
$ sudo dnf install wireguard-tools
Mageia [tools – v1.0.20210914]
$ sudo urpmi wireguard-tools
Arch [module – v1.0.20220627 & tools – v1.0.20210914]
$ sudo pacman -S wireguard-tools
Users of kernels < 5.6 may also choose wireguard-lts or wireguard-dkms+linux-headers, depending on which kernel is used.
OpenSUSE/SLE [tools – v1.0.20210914]
$ sudo zypper install wireguard-tools
Slackware [tools – v1.0.20210914]
$ sudo slackpkg install wireguard-tools
Alpine [tools – v1.0.20210914]
# apk add -U wireguard-tools
Gentoo [module – v1.0.20220627 & tools – v1.0.20210914]
# emerge wireguard-tools
The wireguard-modules ebuild also exists for compatibility with older kernels.
Exherbo [module – v1.0.20211208 – out of date & tools – v1.0.20210914]
# cave resolve -x wireguard
NixOS [module – v1.0.20211208 – out of date & tools – v1.0.20210914]
boot.extraModulePackages = [ config.boot.kernelPackages.wireguard ];
environment.systemPackages = [ pkgs.wireguard pkgs.wireguard-tools ];
Nix on Darwin [userspace go – v0.0.20220316 & tools – v1.0.20210914]
$ nix-env -iA nixpkgs.wireguard-tools
OpenWRT [tools – v1.0.20210914]
# opkg install wireguard
Further installation and configuration instructions may be found on the wiki.
Oracle Linux 8 [UEK6 & tools – v1.0.20200827 – out of date]
# dnf install oraclelinux-developer-release-el8
# dnf config-manager --disable ol8_developer
# dnf config-manager --enable ol8_developer_UEKR6
# dnf config-manager --save --setopt=ol8_developer_UEKR6.includepkgs='wireguard-tools*'
# dnf install wireguard-tools
Red Hat Enterprise Linux 8 [module-kmod – v1.0.20220627, module-dkms – v1.0.20220627, & tools – v1.0.20210914]
Method 1: the easiest way is via ELRepo's pre-built module:
$ sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm https://www.elrepo.org/elrepo-release-8.el8.elrepo.noarch.rpm
$ sudo yum install kmod-wireguard wireguard-tools
Method 2: users running non-standard kernels may wish to use the DKMS package instead:
$ sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
$ sudo subscription-manager repos --enable codeready-builder-for-rhel-8-$(arch)-rpms
$ sudo yum copr enable jdoss/wireguard
$ sudo yum install wireguard-dkms wireguard-tools
CentOS 8 [module-plus – v1.0.20210606 – out of date, module-kmod – v1.0.20220627, module-dkms – v1.0.20220627, & tools – v1.0.20210914]
Method 1: a signed module is available as built-in to CentOS's kernel-plus:
$ sudo yum install yum-utils epel-release
$ sudo yum-config-manager --setopt=centosplus.includepkgs="kernel-plus, kernel-plus-*" --setopt=centosplus.enabled=1 --save
$ sudo sed -e 's/^DEFAULTKERNEL=kernel-core$/DEFAULTKERNEL=kernel-plus-core/' -i /etc/sysconfig/kernel
$ sudo yum install kernel-plus wireguard-tools
$ sudo reboot
Method 2: the easiest way is via ELRepo's pre-built module:
$ sudo yum install elrepo-release epel-release
$ sudo yum install kmod-wireguard wireguard-tools
Method 3: users running non-standard kernels may wish to use the DKMS package instead:
$ sudo yum install epel-release
$ sudo yum config-manager --set-enabled PowerTools
$ sudo yum copr enable jdoss/wireguard
$ sudo yum install wireguard-dkms wireguard-tools
Oracle Linux 7 [UEK6 & tools – v1.0.20200827 – out of date]
# yum install oraclelinux-developer-release-el7
# yum-config-manager --disable ol7_developer
# yum-config-manager --enable ol7_developer_UEKR6
# yum-config-manager --save --setopt=ol7_developer_UEKR6.includepkgs='wireguard-tools*'
# yum install wireguard-tools
Red Hat Enterprise Linux 7 [module-kmod – v1.0.20220627, module-dkms – v1.0.20220627, & tools – v1.0.20210914]
Method 1: the easiest way is via ELRepo's pre-built module:
$ sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm https://www.elrepo.org/elrepo-release-7.el7.elrepo.noarch.rpm
$ sudo yum install kmod-wireguard wireguard-tools
Method 2: users running non-standard kernels may wish to use the DKMS package instead:
$ sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
$ sudo curl -o /etc/yum.repos.d/jdoss-wireguard-epel-7.repo https://copr.fedorainfracloud.org/coprs/jdoss/wireguard/repo/epel-7/jdoss-wireguard-epel-7.repo
$ sudo yum install wireguard-dkms wireguard-tools
CentOS 7 [module-plus – v1.0.20210606 – out of date, module-kmod – v1.0.20220627, module-dkms – v1.0.20220627, & tools – v1.0.20210914]
Method 1: a signed module is available as built-in to CentOS's kernel-plus:
$ sudo yum install yum-utils epel-release
$ sudo yum-config-manager --setopt=centosplus.includepkgs=kernel-plus --enablerepo=centosplus --save
$ sudo sed -e 's/^DEFAULTKERNEL=kernel$/DEFAULTKERNEL=kernel-plus/' -i /etc/sysconfig/kernel
$ sudo yum install kernel-plus wireguard-tools
$ sudo reboot
Method 2: users wishing to stick with the standard kernel may use ELRepo's pre-built module:
$ sudo yum install epel-release elrepo-release
$ sudo yum install yum-plugin-elrepo
$ sudo yum install kmod-wireguard wireguard-tools
Method 3: users running non-standard kernels may wish to use the DKMS package instead:
$ sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-latest-7.noarch.rpm
$ sudo curl -o /etc/yum.repos.d/jdoss-wireguard-epel-7.repo https://copr.fedorainfracloud.org/coprs/jdoss/wireguard/repo/epel-7/jdoss-wireguard-epel-7.repo
$ sudo yum install wireguard-dkms wireguard-tools
FreeBSD [kmod – v0.0.20220615, userspace go – v0.0.20220316 & tools – v1.0.20210914]
# pkg install wireguard
OpenBSD [tools – v1.0.20210914]
# pkg_add wireguard-tools
Termux [tools – v1.0.20210914]
# pkg install wireguard-tools
Void [module – v1.0.20220627 & tools – v1.0.20210914]
# xbps-install -S wireguard-tools wireguard-dkms
Adélie Linux [module – v1.0.20210424 – out of date & tools – v1.0.20210424 – out of date]
# apk add wireguard-tools wireguard-module
Source Mage [tools – v1.0.20210914]
# cast wireguard-tools
Buildroot [module – v1.0.20211208 – out of date & tools – v1.0.20210914]
BR2_PACKAGE_WIREGUARD_LINUX_COMPAT=y
BR2_PACKAGE_WIREGUARD_TOOLS=y
EdgeOS [module – v1.0.20220627 & tools – v1.0.20210914]
$ sudo dpkg -i wireguard-{type}-{version}.deb
First download the correct prebuilt file from the release page, and then install it with dpkg as above.
AstLinux [module – v1.0.20220627 & tools – v1.0.20210914]
BR2_PACKAGE_WIREGUARD_TOOLS=y
BR2_PACKAGE_WIREGUARD=y
Milis [module – v1.0.20200908 – out of date & tools – v1.0.20200827 – out of date]
# mps kur wireguard-tools wireguard-linux-compat
macOS Homebrew and MacPorts – Basic CLI [homebrew userspace go – v0.0.20220316 & homebrew tools – v1.0.20210914] & [macports userspace go – v0.0.20220316 & macports tools – v1.0.20210914]
$ brew install wireguard-tools
or
$ port install wireguard-tools
See the cross-platform documentation for more information.
Move on to the quick start walkthrough. Or, if your distribution isn't listed above, you may easily compile from source instead, a fairly simple procedure.
