Direct answer
For the Ubiquiti UniFi Cloud Gateway Ultra, provider/server, credentials, protocol, DNS, MTU, policy route and double NAT should be isolated. First, test tunnel status and endpoint reachability on one client.
What this covers
- Ubiquiti UniFi Cloud Gateway Ultra (UCG-Ultra)
- UniFi network; Network application version, gateway ownership, VLANs, PoE and adoption state are part of every diagnosis.
- The specific fault this record addresses: VPN client or server will not connect
What it does not cover
- ×The same symptom on a different Ubiquiti product line, which has its own record and its own cited source
- ×An on-screen error code whose meaning has not been checked against this exact model's manual
- ×Live electrical, gas, sealed-system, internal battery-cell or structural repair — a technician boundary, not a self-service step
Differential
What actually causes this, and how to tell them apart
These are ordered by how often each one is the answer, not by how easy it is to try. The point of the middle column is that two causes producing the same headline symptom rarely produce the same detail — that detail is what tells you which one you have before you change anything.
- 1
A VPN client app cannot connect or breaks other traffic
What separates it A single device's VPN app fails to connect, or once connected some sites or local devices stop working.
How to confirm Test the VPN app on another network to separate the app from your router; local-device access breaking while connected is normal VPN routing, adjusted with split-tunnelling in the app.
- 2
A router-level VPN client is misconfigured
What separates it The router routes all traffic through a VPN provider and connections are slow, failing, or leaking.
How to confirm Verify the router VPN's credentials, server and kill-switch settings; a router VPN affects every device at once, so a bad config takes the whole network down.
- 3
An inbound VPN server (to reach home) is unreachable
What separates it You cannot connect back to your home VPN server from outside.
How to confirm Confirm the server's port is forwarded and that the line is not behind carrier-grade NAT — an inbound VPN needs a reachable public address, exactly like port forwarding.
- 4
An MTU or protocol mismatch is dropping the tunnel
What separates it The VPN connects but stalls on large transfers or specific sites.
How to confirm Lower the MTU or switch the VPN protocol per the provider's guidance; an MTU that is too high for the tunnel silently drops large packets.
Before you touch a setting
Record this first — changing settings destroys the evidence
Every item below stops existing the moment a reset, re-pair or settings change is made. Written down first, they are what separates the causes above; recovered afterwards, they are guesswork.
- Which VPN you mean: a client app, a router-level VPN client, or an inbound home VPN server.
- Whether it fails to connect at all, or connects then breaks specific traffic.
- For an inbound server: whether the port is forwarded and the line has a public IP.
Establish which of the three VPN roles is involved
ReversibleClient app, router-level client, or inbound server — the fixes barely overlap.
Test a client-app VPN on another network to isolate it
ReversibleSeparates the app from your router and line.
For a router VPN, verify credentials, server and kill-switch
ReversibleA router VPN misconfig takes down every device at once.
For an inbound server, confirm the forward and a public IP, and tune MTU
ReversibleAn inbound VPN needs a reachable address; MTU mismatches drop large transfers.
Model-specific
What is true of this model and not of its siblings
Generic advice for the product line fails here. Each item below is a property of this specific model family that changes which of the steps above apply to you.
- Model scope
- UCG-Ultra. UniFi network; Network application version, gateway ownership, VLANs, PoE and adoption state are part of every diagnosis.
- Type — compact GATEWAY/router, NO Wi-Fi
- The UCG-Ultra is a small UniFi gateway (router, firewall, UniFi Network controller) with NO built-in Wi-Fi radio — it does not broadcast wireless. Wi-Fi symptoms do not apply; add separate UniFi APs. It is the compact, affordable way into the UniFi ecosystem.
- Needs separate access points
- 'No Wi-Fi' is expected — the Wi-Fi comes from UniFi APs connected to it (via a PoE switch/injector). Troubleshoot Wi-Fi at the APs.
- UniFi controller/app
- Runs the UniFi Network application on-device (managed web/app). Advanced compared with consumer routers.
- Symptom boundary
- This record covers Ubiquiti UniFi Cloud Gateway Ultra when it VPN client or server will not connect. A different symptom on the same hardware, or this symptom on a different Ubiquiti product line, has its own record with its own causes and its own cited source.
Stop boundary
When this stops being a self-service repair
Continuing past any one of these costs more than the repair saves — in safety, in warranty, or in evidence a technician needs.
- !Do not disable a router VPN's kill-switch to 'fix' connectivity — that silently leaks your traffic unencrypted. Resolve the tunnel instead.
Evidence ledger
Sources behind this answer
Visible sources support the visible claims. Home Product Support records the publisher, the fact used and the review date; community reports can suggest an issue but do not become a published fact on their own.
Where the manufacturer's article stops. Ubiquiti Help Center publishes this as "UniFi Remote Access: VPN and Port Forwarding". Ubiquiti's own device-agnostic VPN setup article. Verified reachable and content-matched via the Browser tool 2026-08-28. What that article does not carry is the model boundary — it is written for a product line, and UCG-Ultra is the scope applied here. Where a control label, terminal, indicator pattern or reset sequence differs on your unit, the manual for that exact model is the authority, not this page and not the article.
Exact questions
Common follow-ups
I set up a UniFi Cloud Gateway Ultra but have no Wi-Fi.+
That is because the Cloud Gateway Ultra has no built-in Wi-Fi radio — it is a compact gateway/router, not a wireless router. You need to add UniFi access points (such as a U6 Pro or U7 Pro), connect them (they need PoE, from a PoE switch or injector), and adopt them in the UniFi Network application running on the gateway. Once an AP is adopted and online, it broadcasts your Wi-Fi. The gateway itself only routes.
My VPN connects but then some things stop working.+
That is usually the VPN's routing rather than a fault. When a VPN is active it sends your traffic through the tunnel, which can cut off local devices (a printer, a NAS) or trip up sites that dislike the VPN's exit. Use split-tunnelling in the app to keep local and trusted traffic off the tunnel. If large transfers specifically stall, it is often an MTU that is too high for the tunnel — lower it per your provider's guidance.
Does this answer apply to every Ubiquiti model?+
No. It is scoped to UCG-Ultra. UniFi network; Network application version, gateway ownership, VLANs, PoE and adoption state are part of every diagnosis.
What should I record before troubleshooting VPN or tunnel?+
Record the complete model identifier, exact message or indicator, software/firmware where visible, the operating stage and what still works.
Why is a factory reset not the first step?+
A reset can erase accounts, networks, maps, schedules or preferences without distinguishing VPN, tunnel. The ordered checks preserve that evidence.
When should I stop and use qualified service?+
Protect keys and preserve emergency/admin access.
Answer for the exact device and software version shown above.