Setup Guide

Connect your WirePath VPN

Step-by-step instructions for every platform. You'll need the wirepath.conf file and QR code that were emailed to you after purchase.

Before you begin

Check your inbox (and spam folder) for an email from noreply@wire-path.com with the subject "Your WirePath VPN is ready". It contains your wirepath.conf file and a QR code image — you'll need one of these to import your tunnel below. If it hasn't arrived after 5 minutes, contact us.

Choose your platform

macOS Setup

Works on macOS 12 Monterey and later. Compatible with both Intel and Apple Silicon Macs.

1

Install WireGuard

Download WireGuard from the Mac App Store — it's free and the official client.

Download on the App Store
2

Save your config file

Open the email from WirePath and save the attached wirepath.conf file to your Mac (e.g. your Downloads folder).

3

Import the tunnel

  1. a. Open WireGuard from your Applications folder or menu bar.
  2. b. Click "Import tunnel(s) from file…" in the bottom-left corner.
  3. c. Select your wirepath.conf file and click Open.
  4. d. If prompted, click "Allow" to let WireGuard add a VPN configuration.
4

Activate the tunnel

Click the toggle switch next to wirepath to connect. The status will change to Active within a few seconds.

You can also enable or disable the VPN from the WireGuard icon in your Mac's menu bar.

5

Verify you're connected

Visit whatismyipaddress.com — your IP address should match the server IP from your welcome email.

Tip: Connect on startup

In WireGuard preferences, you can set the tunnel to connect automatically when your Mac boots.

Quick info

  • ✓ macOS 12+
  • ✓ Intel & Apple Silicon
  • ✓ Menu bar quick-toggle
  • ✓ Free from App Store

Troubleshooting

  • Can't import file? Make sure the file ends in .conf — some mail clients rename attachments.
  • Toggle greyed out? macOS needs permission to add a VPN. Go to System Settings → Privacy & Security and allow WireGuard.
  • No internet when connected? Wait 2–3 minutes after purchase — the server may still be provisioning.

Windows Setup

Works on Windows 10 and Windows 11 (64-bit). Requires administrator access to install.

1

Download and install WireGuard

Download the official Windows installer from wireguard.com — it's free and open source.

Download WireGuard for Windows

Run the downloaded wireguard-installer.exe and click through the installer. Click Yes if Windows asks for admin permission.

2

Save your config file

Open the email from WirePath and save the attached wirepath.conf file somewhere easy to find, such as your Desktop or Downloads folder.

3

Import the tunnel

  1. a. Open WireGuard from the Start Menu.
  2. b. Click the "Import tunnel(s) from file…" button at the bottom of the left panel. Alternatively, drag your .conf file directly onto the WireGuard window.
  3. c. Select your wirepath.conf file and click Open.
4

Activate the tunnel

Select wirepath in the left panel, then click the "Activate" button. The status will change to Active.

To disconnect, click "Deactivate". WireGuard also appears in the Windows system tray for quick access.

5

Verify you're connected

Visit whatismyipaddress.com — your IP address should match the server IP from your welcome email.

Tip: Launch on startup

Right-click the WireGuard system tray icon and choose Launch WireGuard on Startup.

Quick info

  • ✓ Windows 10 & 11
  • ✓ 64-bit required
  • ✓ System tray quick-toggle
  • ✓ Free, open source

Troubleshooting

  • Installer blocked? Windows Defender SmartScreen may flag unfamiliar installers. Click "More info" → "Run anyway" — the WireGuard installer is signed by the WireGuard project.
  • No internet when connected? Wait 2–3 minutes after purchase for the server to finish provisioning.
  • DNS leaks? Your config points DNS to your server's private resolver (10.0.0.1) — queries never leave your server or touch a third-party resolver.

Linux Setup

WireGuard is built into the Linux kernel (5.6+). These instructions work on Ubuntu, Debian, Fedora, Arch, and most modern distros.

1

Install WireGuard tools

Choose the command for your distribution:

Ubuntu / Debian

sudo apt install wireguard

Fedora / RHEL / CentOS Stream

sudo dnf install wireguard-tools

Arch Linux

sudo pacman -S wireguard-tools

openSUSE

sudo zypper install wireguard-tools
2

Copy the config file

Save the wirepath.conf attachment from your email, then move it to the WireGuard config directory:

sudo cp ~/Downloads/wirepath.conf /etc/wireguard/wirepath.conf

Adjust the source path if you saved it somewhere other than Downloads.

3

Lock down config permissions

The config contains your private key — restrict read access:

sudo chmod 600 /etc/wireguard/wirepath.conf
4

Connect to the VPN

sudo wg-quick up wirepath

To disconnect: sudo wg-quick down wirepath

5

Verify the connection

Check that the tunnel is active:

sudo wg show

You should see a latest handshake timestamp — that confirms you're connected. You can also check your public IP: curl ifconfig.me

6

Auto-connect on boot (optional)

Enable the WireGuard systemd service so it starts automatically:

sudo systemctl enable --now wg-quick@wirepath

To disable auto-start: sudo systemctl disable wg-quick@wirepath

Using a desktop GUI?

GNOME and KDE both have built-in WireGuard support in Network Settings. You can import the .conf file directly via the network manager GUI without using the terminal.

Quick info

  • ✓ Kernel 5.6+ built-in
  • ✓ All major distros
  • ✓ systemd auto-start
  • ✓ CLI or GUI

Troubleshooting

  • Module not found? On kernels older than 5.6, install the DKMS module: sudo apt install wireguard-dkms
  • Permission denied on /etc/wireguard? The directory may not exist yet — create it first: sudo mkdir /etc/wireguard
  • No route to host? Check your firewall isn't blocking UDP egress traffic.

iPhone & iPad Setup

The easiest way is to scan the QR code from your email — it takes under 30 seconds. Requires iOS 15 or later.

1

Install WireGuard

Download the free WireGuard app from the App Store.

Download on the App Store

Option A — Scan QR code (recommended, fastest)

2a

Open the email from WirePath on a different device (computer or another phone) so you can scan the QR code image with your iPhone.

3a

Open the WireGuard app on your iPhone, tap the "+" button in the top-right, then select "Create from QR code".

4a

Point your iPhone camera at the QR code displayed on the other screen. Once scanned, give the tunnel a name (e.g. WirePath) and tap Save.

Option B — Import config file

2b

Open the WirePath email directly on your iPhone (in Mail, Gmail, or another email app). Tap and hold the wirepath.conf attachment, then choose "Share" → "Copy to WireGuard".

3b

Alternatively, save the file to iCloud Drive or Files, then in WireGuard tap "+" → "Create from file or archive" and select it.

5

Connect

Tap the toggle next to your tunnel. iOS will ask permission to add a VPN configuration — tap Allow.

A VPN icon will appear in the iOS status bar when you're connected. Tap the toggle again to disconnect.

Tip: On-Demand activation

In WireGuard, tap the tunnel name → Edit → On-Demand Activation. You can set WirePath to connect automatically on Wi-Fi, cellular, or both.

Quick info

  • ✓ iOS 15+
  • ✓ iPhone & iPad
  • ✓ QR code import
  • ✓ On-demand VPN

Troubleshooting

  • Can't see QR code option? Make sure WireGuard is fully installed — close and reopen the app.
  • No internet after connecting? The server may still be provisioning — wait 2–3 minutes and try again.
  • App says "No permission"? Go to Settings → General → VPN & Device Management and ensure WireGuard has VPN permission.

Android Setup

Works on Android 5.4 (Lollipop) and later. Scanning the QR code is the quickest method.

1

Install WireGuard

Download the official WireGuard app from Google Play.

Get it on Google Play

No Google Play? Download the APK directly from wireguard.com/install.

Option A — Scan QR code (recommended, fastest)

2a

Open the email from WirePath on a different device (computer or another phone) so you can scan the QR code with your Android phone.

3a

Open the WireGuard app on your Android phone, tap the "+" button in the bottom-right corner, then select "Scan from QR code".

4a

Point your Android camera at the QR code. Once recognised, give the tunnel a name and tap Create tunnel.

Option B — Import config file

2b

Open the WirePath email on your Android phone and save (download) the wirepath.conf attachment to your Downloads folder.

3b

In the WireGuard app, tap "+" → "Import from file or archive", navigate to Downloads, and select wirepath.conf.

5

Connect

Tap the toggle next to your tunnel to activate it. Android will ask you to allow WireGuard to set up a VPN — tap OK.

A key icon in the status bar indicates the VPN is active. Tap the toggle again to disconnect.

6

Verify you're connected

Open a browser and visit whatismyipaddress.com. Your IP address should match the server IP in your WirePath welcome email.

Tip: Always-on VPN

Go to Android Settings → Network & internet → VPN, tap the gear icon next to WireGuard, and enable Always-on VPN. This keeps your tunnel active even after a reboot.

Quick info

  • ✓ Android 5.4+
  • ✓ QR code import
  • ✓ Always-on VPN
  • ✓ APK available too

Troubleshooting

  • Can't download APK? Enable "Install unknown apps" in Settings → Security for your browser.
  • QR scan not working? Make sure you've granted camera permission to WireGuard.
  • No internet after connecting? The server may still be provisioning — wait 2–3 minutes and reconnect.

Need help?

Find answers to common questions about your config file, multiple devices, QR codes, and connection issues.

Visit the Help & FAQ page