WireGuard is a modern VPN (Virtual Private Network) software. It is designed to be run almost anywhere and to be cross-platform. Compared to other similar software, it is faster, more secure and simpler.
Important: WireGuard is currently under development.
Note: WireGuard needs kernel modules that are not yet implemented in the kernel. The installation process will install new kernel modules via DKMS.
The installation process is based on Ubuntu. Documentation regarding other platforms is available on the WireGuard website.
1 . Connect to your server via SSH.
2 . Install Linux kernel headers and WireGuard.
$ sudo apt-get install linux-headers-$(uname --kernel-release) # installs the right kernel headers for your version $ sudo add-apt-repository ppa:wireguard/wireguard $ sudo apt-get update $ sudo apt-get install wireguard
Important: To install the Linux kernel headers, your instance must be configured to boot using local boot and running on a Linux kernel ≥ 3.10.
Once WireGuard is installed, you can check that the installation succeeded by running:
wg, if you get no output it’s all good. In order to check that the WireGuard kernel module has loaded you can run
sudo modprobe wireguard.
WireGuard relies on a public/private key authentication (asymmetric cryptography;; thus you need to create those keys. They are easily created with the
wg genkey and
wg pubkey subcommands.
1 . First let’s create a directory to store these keys.
# mkdir -p /etc/wireguard/keys
2 . Now you can create the public and private key. The creation of the private key is done with
wg genkey and the public key is generated by piping it into
umask tells the system to set the permissions of the new files to
# cd /etc/wireguard/keys # umask 077 # wg genkey | tee privatekey | wg pubkey > publickey
The first step is to choose an IP range which will be used by the server. The private IP ranges defined by the RFC 19198 are the following:
For this tutorial we will use
192.168.66.0/24 which is inside the
192.168.0.0/16 range. The server will have the following IP address:
192.168.66.1. It is also required to choose a port, which will be exposed publicly, for the server to listen on. Here it will be
8999. Note that the standard documentation port is usually 51820.
Create the file
/etc/wireguard/wg0.conf with the following content:
[Interface] PrivateKey = <private key of the server> Address = 192.168.66.1/32 ListenPort = 8999
1 . On Linux you can install WireGuard the same way you did for the server. To install WireGuard on MacOS just run:
brew install wireguard-tools. You can also use the Mac App Store application. To install WireGuard on Windows you can find the executable on the WireGuard installation page but this guide will not cover the Windows use case.
2 . Once installed you will need to create the key pair as well:
# mkdir -p /etc/wireguard/keys # cd /etc/wireguard/keys # umask 077 # wg genkey | tee privatekey | wg pubkey > publickey
3 . After the keys are created, it is time to write the configuration file
[Interface] PrivateKey = <private key of the client> Address = 192.168.66.2/32 DNS = 188.8.131.52 [Peer] PublicKey = <public key of the server> Endpoint = <public ip of the server>:8999 AllowedIPs = 0.0.0.0/0 PersistentKeepalive = 25
It is quite similar to the server configuration. The
DNS line specifies the DNS resolver for the client. The
Endpoint tells WireGuard where to connect.
AllowedIPs configures which IP range will be forwarded to the VPN server. In this case,
0.0.0.0/0 means that all the traffic from the client will go through the VPN. If you only want to communicate within the VPN network, you can set
PersistentKeepalive tells WireGuard to send a UDP packet every 25 seconds, this is useful if you are behind a NAT and you want to keep the connection alive.
Important: If you decide to route all your traffic to the VPN server be sure to do the following on the server:
- Add the following lines in the
[Interface]section of the server (Replace
ens2by your main network interface if it is not
PostUp = sysctl -w net.ipv4.ip_forward=1; iptables -A FORWARD -i %i -j ACCEPT; iptables -t nat -A POSTROUTING -o ens2 -j MASQUERADE
PostDown = iptables -D FORWARD -i %i -j ACCEPT; iptables -t nat -D POSTROUTING -o ens2 -j MASQUERADE
4 . Now that the client is configured, you need to add the peer configuration to the server. Just add the following to your
/etc/wireguard/wg0.conf on the server:
[Peer] PublicKey = <public key of the client> AllowedIPs = 192.168.66.2/32 # the ip address in the VPN network of the client you just created
There are two ways to configure the Android or iOS client. The easiest one is to follow the previous part and once the configuration file is done, export it with qrencode like this:
qrencode -t ansiutf8 < path/to/phone.conf. Finally scan the generated QR code with the WireGuard application.
For the second way, follow these steps:
1 . Once the application is downloaded, open the application and click on the + icon and select Create from scratch.
2 . You will need to click on GENERATE to generate the key pair (copy the public key in order to use in on the server). The rest is like the Linux client configuration, fill in the addresses, DNS servers and name. Now you will need to add the server as a peer.
3 . Click on ADD PEER and add the public key of the server, the public IP of the server and the port on which it is listening. If you decide to route all the traffic through the VPN, please read the Important section above.
4 . Finally, add the following to the server’s
[Peer] PublicKey = <public key of the android client> AllowedIPs = 192.168.66.3/32 # the ip address in the VPN network of the client you just created
Now that everything is configured, you can launch the WireGuard server with:
# wg-quick up wg0
And start the client with the same command:
# wg-quick up wg0
You can also enable the start of WireGuard at boot time with the following command:
# systemctl enable firstname.lastname@example.org
You can check the connection with the
wg command (client or server):
# wg # on the client interface: wg0 public key: <public key of the client> private key: (hidden) listening port: 57576 fwmark: 0xca6c peer: <public key of the server> endpoint: <public IP of the server>:8999 allowed ips: 0.0.0.0/0 latest handshake: 50 seconds ago transfer: 8.35 KiB received, 18.00 KiB sent persistent keepalive: every 25 seconds # ping 192.168.66.1 PING 192.168.66.1 (192.168.66.1) 56(84) bytes of data. 64 bytes from 192.168.66.1: icmp_seq=1 ttl=64 time=3.50 ms 64 bytes from 192.168.66.1: icmp_seq=2 ttl=64 time=4.53 ms --- 192.168.66.1 ping statistics --- 2 packets transmitted, 2 received, 0% packet loss, time 3ms rtt min/avg/max/mdev = 3.499/4.015/4.532/0.520 ms # curl ifconfig.co <public IP of the server>
As you can see, you can ping the VPN server through the VPN and all your traffic is being routed through the VPN server.
For more information you can check the WireGuard website.
The next tutorial with WireGuard will be about setting up a virtual private network between servers with WireGuard acting as a mesh VPN.
“WireGuard” is a registered trademark of Jason A. Donenfeld.