Search

Download App

WireGuard Guide - PiFi

WireGuard Guide - PiFi

Guide to WireGuard on PiFi

Everything you need to know about WireGuard on PiFI

Step 1: WireGuard (Prerequisites)

You’ll need:

1.1 A VPN Account (that supports WireGuard)

(e.g Surfshark, PureVPN etc) — not all VPN providers provide Wireguard config files so it’s worth checking yours does

1.2 WireGuard Config File(s)

From the VPN provider website, download onto your phone whichever WireGuard config files you’d like on your PiFi (these are server configuration files that let you connect to a region e.g UK, US etc)

You can typically find WireGuard Config Files by searching, for example, “PureVPN + Wireguard Configuration Files” in Google (substitute PureVPN for your actual provider) or consult your providers documentation.

Step 2: How to Setup WireGuard

2.1: Open the app, and tap ‘VPN’

image

2.2: Ensure that Protocol is set to WireGuard

image

If you would like to use the WireGuard protocol with PiFi, confirm that the PiFi badge shows WG and that connect button shows ‘Connect WireGuard’ - (both underlined in green, above).

If instead it shows OVPN under the PiFI badge or ‘Connect OpenVPN’ - tap the toggle button (illustrated highlighted by yellow box in picture above) and then choose ‘WireGuard’

Tip: If your VPN provider does not support WireGuard and provides config files, you should be able to connect to VPN via OpenVPN - tap here to set the guide

2.3: Upload and Connect

image
  • Tap on ‘Connect WireGuard’
image
  • Tap + Setup VPN then select ‘Upload WireGuard Config’
  • Choose the WireGuard file you downloaded in step 1 from your phone files/downloads
image
  • Tap on the WireGuard Profile you just uploaded to connect

You’re All Set 🎉

image
💡
Important: 🚥 On PiFi - a red/orange LED on Raspberry Pi means VPN is off, and after booting a green LED suggests VPN is enabled. This differs from the usual LED pattern, particularly on Raspberry Pi 5 which suggests it’s in “shutdown state”. So red/orange LED is nothing to worry about

Additional VPN Options

Rename VPN Files

An OpenVPN filename such as uk9282.provider.conf is not very great to look at but you can rename it to something like United Kingdom or London in the app. Just tap on App > VPN > Connect Wireguard > Choose the ‘…’ button next to the VPN profile and select Rename

Force ‘AdGuard Home’ DNS

If you would like to force override your VPN providers DNS and use whichever DNS you have set in AdGuard Home you can do so by going to App > Settings > More Settings > VPN Client and toggle on Overrule DNS

More help & support

Need help or more tips, see the PiFi community