Technical Anshu
Tutorials Blog
📲 First Client

Add Your First WireGuard Client with Config File and QR Code

Server ready, now the devices. The Untangle app hands every client its setup in two forms — a config file for computers and a QR code for phones. Here is the clean onboarding flow for both, plus the test most people skip.

✍️ Technical Anshu📱 Windows • Android • iPhone⏱️ 5 minute read
🎥 Full process in the video — WireGuard VPN server on the Untangle firewall, tunnel setup and client connection, step-by-step

In the video, client setup takes the last two minutes — because the firewall does the hard part. What follows is that same flow written down carefully: tunnel on the server first, config second, honest test last. Follow it in this order and the first client is also the easiest client.

Untangle — Tunnels tab, Remote Client view (illustration)
Tunnels ------------------------------------------------ Name Address [Remote Client] Ramesh-Laptop 10.10.10.2 View config Priya-Phone 10.10.10.3 View config Remote Client view shows: [ QR CODE ] + client config as copyable text

Illustrative panel — the Remote Client view is where every client config and QR code comes from. Example addresses are illustrations.

1

Create the Tunnel on the Firewall First

Every client begins life on the server side. In the WireGuard app, open the Tunnels tab and click Add. Name the tunnel after the person and the device — Ramesh-Laptop, not Tunnel-2 — because in six months this list is your audit record. Save it, and the tunnel now exists with its own address and keys, waiting for its device.

2

Windows: Import the Config File

  1. On the Windows PC, download and install the WireGuard client from wireguard.com — the official site only.
  2. In the firewall's Tunnels tab, open this tunnel's Remote Client view and save or copy the text configuration.
  3. In the WireGuard client, click Add Tunnel → Import tunnel(s) from file and pick the saved file — or create an empty tunnel and paste the text.
  4. Click Activate. A "latest handshake" line and moving transfer counters mean you are in.
3

Phone: Scan the QR Code

  1. Install the official WireGuard app from the Play Store or App Store.
  2. Tap +, then Scan from QR code, and allow the camera permission.
  3. Point it at the QR code in the tunnel's Remote Client view, give the tunnel a name, and tap Create Tunnel.
  4. Approve the phone's VPN connection request, then switch the tunnel on.

The whole phone onboarding takes about a minute — which is exactly why the QR code must be guarded: that minute works for anyone holding a photo of it.

4

Test It From Outside, Not From Your Desk

A laptop tested on office Wi-Fi can appear to work even with a broken setup, because it never really left the building. Do the honest test: on the phone, turn Wi-Fi off and connect over mobile data; on a laptop, use a phone hotspot. Then open an office-only resource — a shared folder or an internal server page. If it loads, the full chain works: internet, firewall, tunnel, access rules. If the tunnel shows a handshake but nothing loads, you are in the access-rules case — the fix guides in this series cover it.

🎥 Watch the Complete WireGuard Setup in the Video

Watch the client being added and connected live at the end of the full setup video.

▶️ Watch Full Video
❓ Common Questions (FAQ)

Where do I download the WireGuard client for Windows?

From the official site, wireguard.com — it is free. Avoid third-party download portals; a VPN client is the worst possible place for a bundled installer.

The QR code will not scan. What now?

Use the text configuration from the same Remote Client view: on the phone, the WireGuard app can also import from a file or clipboard. Enlarging the QR code on screen and raising screen brightness fixes most scan failures.

Can I send the config file by email or WhatsApp?

You can, but understand what you are sending: the file is the credential itself. A private message to the right person is normal practice; a group chat or a shared mailbox is not. If a file ever goes to the wrong place, delete that tunnel and issue a fresh one.

This guide is based on the Technical Anshu WireGuard VPN server video • Stuck on a step? Ask in the video comments — you will get a reply 🙏