How to connect to WireGuard

This guide shows how to set up a WireGuard client and bring up a VPN connection using a configuration file you received from Skyscrapers.

On most operating systems the official WireGuard client is straightforward to install and use: head to the WireGuard download page, pick the package for your OS, import the .conf file we provided, and activate the tunnel. We’ve focused this guide on Ubuntu (and Debian derivatives) because that is where we have run into the most setup friction in practice. If you’re on macOS or Windows, the official installer takes care of almost everything for you.

Before you start

You need:

  • A Linux machine with sudo access. Steps below are written for Ubuntu and Debian and their derivatives.
  • A WireGuard configuration file (*.conf) provided by Skyscrapers.

Steps

1. Install the WireGuard client

sudo apt update && sudo apt install wireguard

2. Install your configuration file

Move the file you received into /etc/wireguard/ and rename it to wg0.conf. The base filename (wg0) becomes the network interface name used in the next step.

sudo mv ./your-config.conf /etc/wireguard/wg0.conf

3. Bring the tunnel up

sudo wg-quick up wg0

4. Verify the connection

sudo wg show

You should see the wg0 interface listed with a recent latest handshake value (within the last few minutes). If latest handshake is missing or stale, the tunnel is not established. Double-check the configuration file and confirm the peer endpoint is reachable.

5. (Optional) Start the tunnel automatically on boot

sudo systemctl enable wg-quick@wg0

Stopping the tunnel

sudo wg-quick down wg0
Last updated on