3

Installation - WireGuard

 7 months ago
source link: https://www.wireguard.com/install/
Go to the source link to view the article. You can view the picture content, updated content and better typesetting reading experience. If the link is broken, please click the button below to view the snapshot at that time.

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]

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.20211029 & f-droid – v1.0.20211029]

Download from Play Store
Download from F-Droid

iOS [app store – v1.0.15]

Download from App Store

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.20211208 & 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 [module – v1.0.20210219 – out of date & tools – v1.0.20210315 – out of date]

$ for i in wireguard-linux-compat wireguard-tools; do wget https://slackbuilds.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 [tools – v1.0.20210914]

# apk add -U wireguard-tools

Gentoo [module – v1.0.20211208 & tools – v1.0.20210914]

# emerge wireguard-tools

The wireguard-modules ebuild also exists for compatibility with older kernels.

Exherbo [module – v1.0.20211208 & tools – v1.0.20210914]

# cave resolve -x wireguard

NixOS [module – v1.0.20211208 & tools – v1.0.20210914]

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

Nix on Darwin [userspace go – v0.0.20210424 – out of date & tools – v1.0.20210914]

$ nix-env -iA nixpkgs.wireguard-tools

OpenWRT [tools – v1.0.20210424 – out of date]

# 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.20211208, module-dkms – v1.0.20211208, & 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.20211208, module-dkms – v1.0.20211208, & 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.20211208, module-dkms – v1.0.20211208, & 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.20211208, module-dkms – v1.0.20211208, & 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.20211105, 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.20210424 – out of date]

# pkg install wireguard-tools

Void [module – v1.0.20211208 & 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.20210424 – out of date]

# cast wireguard-tools

Buildroot [module – v1.0.20210606 – out of date & tools – v1.0.20210914]

BR2_PACKAGE_WIREGUARD_LINUX_COMPAT=y
BR2_PACKAGE_WIREGUARD_TOOLS=y

EdgeOS [module – v1.0.20211208 & 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.20211208 & 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.


About Joyk


Aggregate valuable and interesting links.
Joyk means Joy of geeK