WireGuard. Setting up client apps

For this article you'll need a .conf configuration file or a QR code — the panel generates them for every WireGuard user, in the expanded row of the list: the file downloads via the Download .conf button, and the QR code is shown right on screen. If you don't have a user yet, start with WireGuard quick start.

Windows

Main app — WireGuard for Windows; project page — wireguard.com/install.

1. Download the installer from the link above and run it — it downloads and installs the right build on its own, there's nothing to pick.
2. Download the .conf file the panel generated for the user, via the Download .conf button.
3. Launch WireGuard. In the window that opens, click "Add Tunnel" and choose "Import tunnel(s) from file…" — point it at the downloaded .conf.
4. The tunnel appears in the list — click "Activate" next to it.

Android

Main app — WireGuard for Android on Google Play.

1. Install the app from the link above.
2. In the panel's expanded user row, leave the QR code on screen, or download the .conf file via the Download .conf button.
3. In the app, tap "+".
4. Choose "Import from file or archive" for the .conf file, or "Scan from QR code" and point the camera at the code on the panel's screen.
5. Turn on the toggle for the added tunnel. Android will show a system prompt to set up a VPN connection — confirm it.

iPhone and iPad

Main app — WireGuard from the App Store.

1. Install the app from the link above.
2. In the panel's expanded user row, leave the QR code on screen, or download the .conf file via the Download .conf button.
3. In the app, tap "Add a tunnel".
4. In the menu that opens, choose "Create from file or archive" for the .conf file, or "Create from QR code" and point the camera at the code on the panel's screen.
5. Turn on the toggle for the added tunnel. iOS will ask permission to add a VPN configuration — allow it and confirm with Face ID, Touch ID, or your passcode.

macOS

Main app — WireGuard from the Mac App Store.

1. Install the app from the link above.
2. Download the .conf file the panel generated for the user, via the Download .conf button.
3. Open WireGuard, click "Import tunnel(s) from file" and pick the downloaded .conf, then confirm with "Import".
4. Turn on the toggle for the added tunnel in the list. macOS will ask permission to add a VPN configuration — confirm with Touch ID or your administrator password.

Checking that the VPN works

Open myip.com in your browser. If everything is set up correctly, the page will show your server's country.

If it doesn't connect

• Check the Enabled toggle in the collapsed user row in the panel — a disabled user's .conf file and QR code don't work.
• On Windows, the WireGuard app only opens under an account that belongs to the "Administrators" group — under a regular account the interface window won't launch.
• Re-importing the same .conf on Android or iOS can be rejected if a tunnel with that name already exists — delete or rename the old tunnel and import again.

⚠️ ISP restrictions

Traffic encryption makes a VPN a reliable way to protect a connection, but in some countries and regions internet providers actively interfere with VPN protocols. Because of this, full availability of the service cannot be guaranteed — regardless of the connection type. If one protocol does not work for you, try another VPN module available in the panel. If none of them work on your network, contact support and we will issue a refund for the license.

What's next

• WireGuard quick start — installing the module and creating the first user.
• WireGuard. Managing users — editing, emailing the configuration, revoking access.