Installation

 Windows [7, 8, 8.1, 10, 2012, 2016, 2019 – v0.1.0]

WireGuard for Windows is available from this site:

 Download for 64-bit (https://download.wireguard.com/windows-client/wireguard-amd64-0.1.0.msi)

Download for 32-bit (https://download.wireguard.com/windows-client/wireguard-x86-0.1.0.msi)

 macOS [app store (https://itunes.apple.com/us/app/wireguard/id1451685025?ls=1&mt=12)

– v0.0.20200127-17]

 Download from App Store (https://itunes.apple.com/us/app/wireguard/id1451685025?ls=1&mt=12)

 Ubuntu ≥ 19.10 [module (https://launchpad.net/ubuntu/+source/wireguard-linux-

compat) – v1.0.20200401 & tools (https://launchpad.net/ubuntu/+source/wireguard) –
v1.0.20200319]

$ sudo apt install wireguard

 Ubuntu ≤ 19.04 [module (https://launchpad.net/~wireguard/+archive/ubuntu/wireguard)

– v1.0.20200401 & tools (https://launchpad.net/~wireguard/+archive/ubuntu/wireguard) –
v1.0.20200319]

$ sudo add-apt-repository ppa:wireguard/wireguard

$ sudo apt-get update
$ sudo apt-get install wireguard

 Android [play store (https://play.google.com/store/apps/details?id=com.wireguard.android)

– v1.0.20200407 & f-droid (https://f-droid.org/en/packages/com.wireguard.android/) –
v1.0.20200401 – out of date (mailto:[email protected]?subject=Please bump the WireGuard fdroid
package&body=Hey,%0a%0aAs a user of your WireGuard fdroid package, I thought I'd let you
know that WireGuard version 1.0.20200407 has been released. Could you bump your package?
%0a%0aThanks!)]

 Download from Play Store (https://play.google.com/store/apps/details?id=com.wireguard.android)

Download from F-Droid (https://f-droid.org/en/packages/com.wireguard.android/)

 iOS [app store (https://itunes.apple.com/us/app/wireguard/id1441195209?ls=1&mt=8) –
v0.0.20200127-17]

 Download from App Store (https://itunes.apple.com/us/app/wireguard/id1441195209?ls=1&mt=8)

 Debian [module (https://packages.debian.org/sid/wireguard-dkms) – v1.0.20200401 & tools

(https://packages.debian.org/sid/wireguard-tools) – v1.0.20200319]

# apt install wireguard

Users with Debian releases older than Bullseye should enable backports
(https://backports.debian.org/Instructions/).

 Fedora ≥ 32 [tools (https://bodhi.fedoraproject.org/updates/?packages=wireguard-tools) –

v1.0.20200319]

$ sudo dnf install wireguard-tools

 Fedora ≤ 31 [module (https://copr.fedorainfracloud.org/coprs/jdoss/wireguard/) –

v1.0.20200330 – out of date (mailto:[email protected]?subject=Please bump the WireGuard
fedora package&body=Hey,%0a%0aAs a user of your WireGuard fedora package, I thought I'd let
you know that wireguard-linux-compat version 1.0.20200401 has been released. Could you bump
your package?%0a%0aThanks!) & tools (https://bodhi.fedoraproject.org/updates/?
packages=wireguard-tools) – v1.0.20200319]

$ sudo dnf copr enable jdoss/wireguard

$ sudo dnf install wireguard-dkms wireguard-tools

 Mageia [module (https://madb.mageia.org/package/show/application/0/name/kernel-

desktop-latest) – v1.0.20200401 & tools
(https://madb.mageia.org/package/show/application/0/name/wireguard-tools) – v1.0.20200319]

$ sudo urpmi wireguard-tools

 Arch [module (https://www.archlinux.org/packages/extra/x86_64/wireguard-dkms/) –

v1.0.20200401 & tools (https://www.archlinux.org/packages/extra/x86_64/wireguard-tools/) –
v1.0.20200319]

$ 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 Tumbleweed [tools
(https://build.opensuse.org/package/show/network:vpn:wireguard/wireguard-tools) –
v1.0.20200319]

$ sudo zypper install wireguard-tools

 OpenSUSE Leap/SLE [module

(https://build.opensuse.org/package/show/network:vpn:wireguard/wireguard) – v1.0.20200401 &
tools (https://build.opensuse.org/package/show/network:vpn:wireguard/wireguard-tools) –
v1.0.20200319]

$ sudo zypper addrepo -f obs://network:vpn:wireguard wireguard

$ sudo zypper install wireguard-kmp-default wireguard-tools

 Slackware [module (https://slackbuilds.org/repository/14.2/network/wireguard-linux-

compat/) – v1.0.20200330 – out of date (mailto:[email protected]?subject=Please bump the
WireGuard slackware package&body=Hey,%0a%0aAs a user of your WireGuard slackware
package, I thought I'd let you know that wireguard-linux-compat version 1.0.20200401 has been
released. Could you bump your package?%0a%0aThanks!) & tools
(https://slackbuilds.org/repository/14.2/network/wireguard-tools/) – v1.0.20200319]

$ for i in wireguard-linux-compat wireguard-tools; do wget https://sla

ckbuilds.org/slackbuilds/14.2/network/$i.tar.gz && tar -xzf $i.tar.gz
&& cd $i && OUTPUT=$(pwd) ./$i.SlackBuild && sudo upgradepkg --install
-new ./$i*.tgz && cd ..; done

 Alpine [module (https://pkgs.alpinelinux.org/packages?name=wireguard-*) – v1.0.20200401

& tools (https://pkgs.alpinelinux.org/packages?name=wireguard-tools) – v1.0.20200319]

# apk add -U wireguard-tools

 Gentoo [module (https://packages.gentoo.org/packages/net-vpn/wireguard-modules) –

v1.0.20200401 & tools (https://packages.gentoo.org/packages/net-vpn/wireguard-tools) –
v1.0.20200319]

# emerge wireguard-tools wireguard-modules

Exherbo [module (https://git.exherbo.org/summer/packages/net/wireguard-linux-

compat/index.html) – v1.0.20200330 – out of date (mailto:[email protected]?subject=Please
bump the WireGuard exherbo package&body=Hey,%0a%0aAs a user of your WireGuard exherbo
package, I thought I'd let you know that wireguard-linux-compat version 1.0.20200401 has been
released. Could you bump your package?%0a%0aThanks!) & tools
(https://git.exherbo.org/summer/packages/net/wireguard-tools/index.html) – v1.0.20200319]

# cave resolve -x wireguard

 NixOS [module (https://github.com/NixOS/nixpkgs/blob/master/pkgs/os-

specific/linux/wireguard/default.nix) – v1.0.20200401 & tools
(https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/networking/wireguard-
tools/default.nix) – v1.0.20200319]

boot.extraModulePackages = [ config.boot.kernelPackages.wireguard ];
environment.systemPackages = [ pkgs.wireguard pkgs.wireguard-tools ];

 Nix on Darwin [userspace go

(https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/networking/wireguard-
go/default.nix) – v0.0.20200121 – out of date (mailto:[email protected]?subject=Please bump
the WireGuard nixos package&body=Hey,%0a%0aAs a user of your WireGuard nixos package, I
thought I'd let you know that WireGuard version 0.0.20200320 has been released. Could you
bump your package?%0a%0aThanks!) & tools
(https://github.com/NixOS/nixpkgs/blob/master/pkgs/tools/networking/wireguard-
tools/default.nix) – v1.0.20200319]

$ nix-env -iA nixpkgs.wireguard-tools

OpenWRT [module (https://git.openwrt.org/?

p=openwrt/openwrt.git;a=blob;f=package/network/services/wireguard/Makefile) –
v1.0.20200401 & tools (https://git.openwrt.org/?
p=openwrt/openwrt.git;a=blob;f=package/network/utils/wireguard-tools/Makefile) –
v1.0.20200319]

# opkg install wireguard

Further installation and configuration instructions may be found on the wiki

(https://openwrt.org/docs/guide-user/network/tunneling_interface_protocols?s[]
=wireguard#protocol_wireguard_wireguard_vpn).
 Red Hat Enterprise Linux 8 [module (http://elrepo.org/tiki/kmod-wireguard) –
v1.0.20200401 & tools (https://bodhi.fedoraproject.org/updates/?packages=wireguard-tools) –
v1.0.20200319]

$ sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-

latest-8.noarch.rpm
$ sudo yum install https://www.elrepo.org/elrepo-release-8.el8.elrepo.
noarch.rpm
$ sudo yum install kmod-wireguard wireguard-tools

 CentOS 8 [module (http://elrepo.org/tiki/kmod-wireguard) – v1.0.20200401 & tools

(https://bodhi.fedoraproject.org/updates/?packages=wireguard-tools) – v1.0.20200319]

$ sudo yum install elrepo-release epel-release

$ sudo yum install kmod-wireguard wireguard-tools

 Red Hat Enterprise Linux 7 [module (http://elrepo.org/tiki/kmod-wireguard) –

v1.0.20200401 & tools (https://bodhi.fedoraproject.org/updates/?packages=wireguard-tools) –
v1.0.20200319]

$ sudo yum install https://dl.fedoraproject.org/pub/epel/epel-release-

latest-7.noarch.rpm
$ sudo yum install https://www.elrepo.org/elrepo-release-7.el7.elrepo.
noarch.rpm
$ sudo yum install kmod-wireguard wireguard-tools

 CentOS 7 [module (http://elrepo.org/tiki/kmod-wireguard) – v1.0.20200401 & tools

(https://bodhi.fedoraproject.org/updates/?packages=wireguard-tools) – v1.0.20200319]

$ sudo yum install epel-release

$ sudo yum install https://www.elrepo.org/elrepo-release-7.el7.elrepo.
noarch.rpm
$ sudo yum install kmod-wireguard wireguard-tools

 FreeBSD [userspace go (https://www.freshports.org/net/wireguard-go) – v0.0.20200320 &

tools (https://www.freshports.org/net/wireguard/) – v1.0.20200319]

# pkg install wireguard

OpenBSD [userspace go (https://cvsweb.openbsd.org/cgi-
bin/cvsweb/~checkout~/ports/net/wireguard-go/Makefile?content-type=text/plain) –
v0.0.20200320 & tools (https://cvsweb.openbsd.org/cgi-
bin/cvsweb/~checkout~/ports/net/wireguard-tools/Makefile?content-type=text/plain) –
v1.0.20200319]

# pkg_add wireguard-go wireguard-tools

Termux [tools (https://github.com/termux/termux-packages/blob/master/packages/wireguard-

tools) – v1.0.20200319]

# pkg install wireguard-tools

Void [module (https://github.com/void-linux/void-packages/tree/master/srcpkgs/wireguard-

dkms) – v1.0.20200401 & tools (https://github.com/void-linux/void-
packages/tree/master/srcpkgs/wireguard-tools) – v1.0.20200319]

# xbps-install -S wireguard-tools wireguard-dkms

Adélie Linux [module (https://code.foxkit.us/adelie/packages/tree/master/user/wireguard-

module) – v1.0.20200401 & tools
(https://code.foxkit.us/adelie/packages/tree/master/user/wireguard-tools) – v1.0.20200319]

# apk add wireguard-tools wireguard-module

Source Mage [module (http://codex.sourcemage.org/test/kernels/wireguard-modules/) –

v1.0.20200401 & tools (http://codex.sourcemage.org/test/net/wireguard-tools/) –
v1.0.20200319]

# cast wireguard-tools wireguard-modules

Buildroot [module (https://git.busybox.net/buildroot/tree/package/wireguard-linux-compat) –

v1.0.20200401 & tools (https://git.busybox.net/buildroot/tree/package/wireguard-tools) –
v1.0.20200319]

BR2_PACKAGE_WIREGUARD_LINUX_COMPAT=y
BR2_PACKAGE_WIREGUARD_TOOLS=y
LinuxKit [module (https://github.com/linuxkit/linuxkit/blob/master/examples/wireguard.yml) –
v1.0.20200401]

kernel:
linuxkit/kernel:...
image:
linuxkit/ip:...

AstLinux [module (https://github.com/astlinux-

project/astlinux/tree/master/package/wireguard) – v1.0.20200401 & tools
(https://github.com/astlinux-project/astlinux/tree/master/package/wireguard-tools) –
v1.0.20200319]

BR2_PACKAGE_WIREGUARD_TOOLS=y
BR2_PACKAGE_WIREGUARD=y

Milis [module
(https://mls.akdeniz.edu.tr/git/milislinux/milis19/src/branch/master/talimatname/2/net-utils) –
v1.0.20200401 & tools
(https://mls.akdeniz.edu.tr/git/milislinux/milis19/src/branch/master/talimatname/2/net-utils) –
v1.0.20200319]

# mps kur wireguard-tools wireguard-linux-compat

 macOS Homebrew and MacPorts – Basic CLI [homebrew userspace go

(http://formulae.brew.sh/formula/wireguard-go) – v0.0.20200320 & homebrew tools
(http://formulae.brew.sh/formula/wireguard-tools) – v1.0.20200319] & [macports userspace go
(https://www.macports.org/ports.php?by=name&substr=wireguard-go) – v0.0.20200320 &
macports tools (https://www.macports.org/ports.php?by=name&substr=wireguard-tools) –
v1.0.20200319]

$ brew install wireguard-tools

or

$ port install wireguard-tools

See the cross-platform documentation (../xplatform/) for more information.

Move on to the quick start walkthrough (../quickstart/). Or, if your distribution isn't listed above,
you may easily compile from source instead (../compilation/), a fairly simple procedure.
 © Copyright 2015-2019 Jason A. Donenfeld. All Rights Reserved. "WireGuard" and the
"WireGuard" logo are registered trademarks (/trademark-policy/) of Jason A. Donenfeld.

This project is from ZX2C4 (https://www.zx2c4.com/) and from Edge Security

(https://www.edgesecurity.com/), a firm devoted to information security research expertise.

(https://www.edgesecurity.com/)