www.wireguard.com Open in urlscan Pro
136.144.57.121  Public Scan

Form analysis
0 forms found in the DOM

Text Content

Toggle navigation WireGuard
 * Installation
 * Quick Start
 * Interworkings
   * Compilation from Source Code
   * Protocol & Cryptography
   * Formal Verification
   * Cross-platform Interface
   * Routing & Network Namespaces
   * Embedding into Applications
   * Build Status
   * Known Limitations
   * Performance
   * Project Todo
   * Presentations

 * Whitepaper
 * Donate
 * 

 * Installation
 * Windows [7, 8.1, 10, 11, 2008R2, 2012R2, 2016, 2019, 2022]
 * macOS [app store]
 * Ubuntu [module & tools]
 * Android [play store & direct apk file]
 * iOS [app store]
 * Debian [module & tools]
 * Fedora [tools]
 * Mageia [tools]
 * Arch [module & tools]
 * OpenSUSE/SLE [tools]
 * Slackware [tools]
 * Alpine [tools]
 * Gentoo [module & tools]
 * Exherbo [module & tools]
 * NixOS [module & tools]
 * Nix on Darwin [userspace go & tools]
 * OpenWRT [tools]
 * Oracle Linux 8 [UEK6 & tools]
 * Red Hat Enterprise Linux 8 [module-kmod, module-dkms, & tools]
 * CentOS 8 [module-plus, module-kmod, module-dkms, & tools]
 * Oracle Linux 7 [UEK6 & tools]
 * Red Hat Enterprise Linux 7 [module-kmod, module-dkms, & tools]
 * CentOS 7 [module-plus, module-kmod, module-dkms, & tools]
 * FreeBSD [kmod, userspace go & tools]
 * OpenBSD [tools]
 * Termux [tools]
 * Void [module & tools]
 * Adélie Linux [module & tools]
 * Source Mage [tools]
 * Buildroot [module & tools]
 * EdgeOS [module & tools]
 * AstLinux [module & tools]
 * Milis [module & tools]
 * macOS Homebrew and MacPorts – Basic CLI [homebrew userspace go & homebrew
   tools] & [macports userspace go & macports tools]


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.16]

Download from App Store

UBUNTU [MODULE – V1.0.20210606 – OUT OF DATE & TOOLS – V1.0.20210914]

$ sudo apt install wireguard


ANDROID [PLAY STORE – V1.0.20231018 & DIRECT APK FILE – V1.0.20231018]

Download from Play Store
Download APK File

IOS [APP STORE – V1.0.16]

Download from App Store

DEBIAN [MODULE – V1.0.20220627 & 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 – VUNKNOWN – OUT OF DATE & TOOLS – VUNKNOWN – OUT OF DATE]

# cave resolve -x wireguard


NIXOS [MODULE – V1.0.20220627 & TOOLS – V1.0.20210914]

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


NIX ON DARWIN [USERSPACE GO – V0.0.20230223 & 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 – VUNKNOWN – OUT OF DATE, MODULE-DKMS –
VUNKNOWN – OUT OF DATE, & 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 – VUNKNOWN –
OUT OF DATE, MODULE-DKMS – VUNKNOWN – OUT OF DATE, & 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 – VUNKNOWN – OUT OF DATE, MODULE-DKMS –
VUNKNOWN – OUT OF DATE, & 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.20220627, MODULE-KMOD – VUNKNOWN – OUT OF DATE,
MODULE-DKMS – VUNKNOWN – OUT OF DATE, & 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 – VUNKNOWN – OUT OF DATE, USERSPACE GO – V0.0.20230223 & 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 – VUNKNOWN – OUT OF DATE & TOOLS – VUNKNOWN – OUT OF DATE]

# apk add wireguard-tools wireguard-module


SOURCE MAGE [TOOLS – V1.0.20210914]

# cast wireguard-tools


BUILDROOT [MODULE – V1.0.20220627 & 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 – VUNKNOWN – OUT OF DATE & TOOLS – VUNKNOWN – OUT OF DATE]

# mps kur wireguard-tools wireguard-linux-compat


MACOS HOMEBREW AND MACPORTS – BASIC CLI [HOMEBREW USERSPACE GO – VUNKNOWN – OUT
OF DATE & HOMEBREW TOOLS – VUNKNOWN – OUT OF DATE] & [MACPORTS USERSPACE GO –
V0.0.20230223 & 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.

© Copyright 2015-2022 Jason A. Donenfeld. All Rights Reserved. "WireGuard" and
the "WireGuard" logo are registered trademarks of Jason A. Donenfeld.

This project is from ZX2C4 and from Edge Security, a firm devoted to information
security research expertise.