How to set up WireGuard on iPhone / iPad
WireGuard is fast and simple. You import one small configuration file (or scan a QR code); there is no username or password to type.
Last reviewed
What you need
- An active WireGuard configuration from this site
- The configuration file (.conf) or the QR code from your configuration page
Where each detail goes
| On your configuration page | In the app or settings |
|---|---|
| Configuration file (.conf) | Import tunnel from file — fills every field for you |
| QR code | Create from QR code / Scan from QR code |
| Endpoint | Peer → Endpoint (already in the file) |
| VPN IP | Interface → Addresses (already in the file) |
Steps
-
Install WireGuard from the App Store (link above).
Illustration — your app may look slightly different. -
On your configuration page, show the QR code on another screen, or download the .conf file to Files.
Illustration — your app may look slightly different. -
In WireGuard tap Add a tunnel → Create from QR code (or Create from file or archive).
Illustration — your app may look slightly different. -
Name the tunnel and tap Allow when iOS asks to add VPN configurations. Confirm with Face ID, Touch ID or your passcode.
Illustration — your app may look slightly different. -
Switch the tunnel on.
Illustration — your app may look slightly different.
Check that it works
Search the web for "what is my IP". The location shown should match the server country of your account.
Disconnect
Switch the tunnel off in WireGuard, or turn VPN off in Settings.
Tips
The "On-Demand" options in the tunnel settings can connect automatically on Wi-Fi or cellular.
Troubleshooting
The tunnel is on but nothing loads
Check that your configuration has not expired (see the countdown on your configuration page). Then switch the tunnel off and on again. Some networks block UDP; if so, try an OpenVPN or V2Ray configuration instead.
Handshake never completes
The configuration is tied to one account. Delete the old tunnel in the app and import the file again from your current configuration page.
I created a new configuration
Every VPN configuration has its own keys. Remove the old tunnel and import the new file or QR code.