🔵
← All setup guides

Ubiquiti UniFi Gateway WireGuard Setup Guide

Manual gateway Works as a gateway for one LAN with no extra steps. Extra VLANs need a few rules added on the device by hand, explained below.

UniFi gateways (UDM, UDM Pro, UDM SE, UCG-Ultra) support WireGuard client natively in UniFi Network 7.x. The controller manages NAT automatically — no PostUp or iptables needed.

1

Create a tunnel in ProxyLink

Go to Devices → + Add → Router / LAN site, select Router / Gateway, enter your LAN subnet, and download your .conf file. On the gateway page, switch the download picker to 🌐 Router (MikroTik / pfSense / OpenWRT) before clicking Activate, otherwise you get a RouterOS .rsc script instead of a .conf file.

2

Open the UniFi Network controller

Log into your UniFi Network application (local or cloud).

3

Create a VPN Client

Go to Settings → VPN → VPN Client → Create New.

  • VPN Type: WireGuard
  • You can import your .conf file directly
  • Or fill in manually: Private Key, Address, Server Public Key, Endpoint, Allowed IPs
4

Enable and test

Toggle the VPN client ON. UniFi handles NAT and routing automatically for traffic assigned to use this tunnel. No iptables rules needed.

5

Route LAN traffic (optional)

To route specific LAN clients or networks through the ProxyLink tunnel, go to Traffic Management → Policy-Based Routing and create a rule targeting your VPN client.

Good to know

UniFi handles NAT transparently. You do not need PostUp rules or any iptables configuration.
UniFi WireGuard support requires UniFi Network 7.x+. Older controller versions do not have this feature.

Reaching more than one VLAN

One LAN needs nothing beyond this guide. If the site has several VLANs (a camera VLAN, a PBX VLAN, a guest network), there is one more thing to know.

ProxyLink gives every gateway its own private address range and translates between that range and your real LAN addresses. That is what lets two different clients both use 192.168.1.0/24 without colliding. The translation rules live in the PostUp and PostDown lines of the config we generate.

Ubiquiti UniFi Gateway cannot run those rules for itself, so extra VLANs are routed directly instead of being translated. Two consequences worth knowing:

If a site has several VLANs and you would rather not maintain that by hand, put a small Linux box (a Raspberry Pi is plenty) or a MikroTik beside the router and use it as the gateway. Both are managed, so every VLAN is handled automatically and the existing router is left alone. See the Linux and MikroTik guides.

What you get once the tunnel is up

Ready to connect?

Create a free account and set up your first tunnel in minutes. Free during early access — no card required.

Setup guides for other platforms