Setting up WireGuard

Recently I decided to set up WireGuard on a Ubuntu 18.04 VM just to try it out. These are my notes on how I did it, including setup instructions for Android and macOS. They largely duplicate a lot of existing articles on how to do this, but I found many articles omit something or other that can take a while to figure out if you haven’t set up a VPN before.

The Server

This was set up using Ubuntu 18.04.3 on DigitalOcean. First, you need to install wireguard:

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

Next, we need to generate the private and public keys

$ sudo su
# cd /etc/wireguard
# umask 077     # so permissions on the files are 600
# wg genkey | tee privatekey | wg pubkey > publickey
# exit

Now we can create our initial config file: /etc/wireguard/wg0.conf. Replace <ServerPrivateKey> with the contents of /etc/wireguard/privatekey.

Address =
Address = fd86:ea04:1111::1/64
SaveConfig = true
PostUp = iptables -A FORWARD -i %i -j ACCEPT; iptables -t nat -A POSTROUTING -o eth0 -j MASQUERADE; ip6tables -A FORWARD -i %i -j ACCEPT; ip6tables -t nat -A POSTROUTING -o eth0 -j MASQUERADE
PostDown = iptables -D FORWARD -i %i -j ACCEPT; iptables -t nat -D POSTROUTING -o eth0 -j MASQUERADE; ip6tables -D FORWARD -i %i -j ACCEPT; ip6tables -t nat -D POSTROUTING -o eth0 -j MASQUERADE
ListenPort = 51820
PrivateKey = <ServerPrivateKey>

The %i refers to the interface name, which is specified when using wg-quick. All the iptables stuff is to allow traffic to pass through the VPN and to the external world, using the external IP address of the server.

To allow forwarding of IP traffic to the external world, you’ll also need to ensure you have the following 2 settings in /etc/sysctl.conf (they’re commented out by default):


Reload sysctl using:

$ sudo sysctl --system

Now let’s allow traffic to port 51820 that we set above:

$ sudo ufw allow 22/tcp         # in case you've never set this before
$ sudo ufw allow 51820/udp
$ sudo ufw enable

And now we can bring up the interface:

$ sudo systemctl enable wg-quick@wg0
$ sudo systemctl start wg-quick@wg0

You can check on the interface using:

$ sudo wg show

Setting up some clients

When setting up clients, we need to generate a key pair on the client, and also decide on an IP address for said client. Let’s say we’re setting up our first client, so for simplicity, the IP addresses will be the server’s plus one; i.e., fd86:ea04:1111::2/128.

Now on the server, we’ll add the new peer:

$ sudo wg set wg0 peer <ClientPublicKey> allowed-ips,fd86:ea04:1111::2/128
$ sudo wg-quick save wg0   # just in case

On the client side, we’ll have a config that looks like this:

PrivateKey = <ClientPrivateKey>
Address =, fd86:ea04:1111::2/128

PublicKey = <ServerPublicKey>
AllowedIPs =, ::/0
Endpoint = <ServerExternalIP>:51820

Depending on your client, you will have different ways of inputting those values (Android gives you a form UI, macOS gives a field in which you type that config).

Some general notes:

  • On Android, if you click “Exclude private IPs”, it may append a blank /32 at the end of the allowed IPs, which is invalid (probably a bug), so you’ll want to remove that.
  • On macOS, you can also set “Exclude private IPs” instead of sending everything through the tunnel
  • If excluding private IPs, you may want to add to the list of allowed IPs so that you can ping your peers.
  • On Android you can leave the DNS Servers field blank, but on macOS you have to set it to something.
  • On macOS you should use “Create tunnel from scratch” so you can write your own config