Skip to content
Ubiquiti UniFi, UniFi OS gateway

UniFi Cloud Gateway captive portal setup

Cloud Gateways are small UniFi OS consoles that act as router and controller in one box. They behave like the UDM family for the integration. The thing that catches groups is the site name: every one of them calls its site default.

Reviewed by , Founder, VoqadoWiFi · Written by the VoqadoWiFi team · Updated

How do I set up a captive portal on a UniFi Cloud Gateway?
Enable the hotspot portal on the guest SSID, choose External Portal Server with www.voqadowifi.com, and allow www.voqadowifi.com and voqadowifi.com in Pre-Authorization Access. Give the gateway a reachable HTTPS address, save it in the dashboard with a local admin and site default, and register each access point MAC if another venue also uses default.

At a glance

Runs
UniFi OS
Login and API prefix
/api/auth/login, then /proxy/network
Usual site id
default
Shared site name risk
Yes, solved by registering access point MACs
Reachability
Port forward 443 or an outbound tunnel

Checked against the VoqadoWiFi integration code on 7 October 2026. Controller menu labels move between firmware releases; the setting names above are the ones the setup wizard prints.

Step by step

  1. Create or open the guest SSID and turn on the hotspot portal
    In Settings, WiFi, use a dedicated open guest SSID and switch on the hotspot or guest portal for it.
  2. Point the external portal server at VoqadoWiFi
    In the hotspot settings choose External Portal Server and enter the host www.voqadowifi.com. UniFi always sends guests to the fixed path /guest/s/<site>/ on that host, which is how VoqadoWiFi knows which venue they are at. If your Network version asks for an IP address, switch on Redirect using hostname and enter the host there instead.
  3. Add the pre-authorization entries and leave HTTPS redirection off
    Add www.voqadowifi.com and voqadowifi.com to Pre-Authorization Access. If your version shows an HTTPS Redirection toggle, leave it off: intercepting HTTPS is what produces certificate warnings on guest phones.
  4. Create a local admin for the integration
    Under Admins and Users add an account restricted to local access, with access to the Network application and no two factor prompt. A ui.com cloud account cannot log in to the controller API, and a two factor challenge fails every automated login.
  5. Give the gateway a reachable address
    The gateway is usually also your edge router, so a DDNS hostname with TCP 443 forwarded to it works when your provider gives you a public address. Behind carrier grade NAT, use an outbound tunnel instead.
  6. Save it in the dashboard and register the access points
    Enter the address with no port, the local admin, Console Type Auto-detect, and site default. Then add the MAC of every access point at the venue to the location’s AP MAC field, separated by commas.

What breaks on this controller

Two venues both on default

When more than one active venue uses the same UniFi site name, VoqadoWiFi matches the ap MAC in the redirect against each venue’s registered access points. If none match, it falls back to the oldest venue, and your guests see someone else’s portal. Register the MACs.

A new access point added later

An access point added after setup is not in the AP MAC list. If the site name is shared, guests on that access point can land on the wrong venue’s portal until you add it.

Carrier grade NAT

Some internet providers put small venues behind carrier grade NAT, where forwarding a port does nothing. Test Connection reports a timeout. An outbound tunnel is the fix.

Questions

Is a Cloud Gateway handled differently from a UDM Pro?
No. Both run UniFi OS, so the integration detects UniFi OS, logs in at /api/auth/login and prefixes Network calls with /proxy/network.
What if I only have one venue?
Then default is fine and the access point MAC list is optional. It matters only when another active venue uses the same site name.
Can I run the portal without exposing the gateway?
Not without a path in. The authorization call has to reach the Network application. An outbound tunnel avoids opening any inbound port.

Deeper reading

Longer articles from the blog that cover this controller. Where an article and this page disagree, this page is the one checked against the current integration.

Keep reading

UniFi setup hubUDM Pro setupGuests see another venue’s portal or a loopWalled garden domains

Sources: lib/unifi/api.ts and app/guest/s/[site]/route.ts (ambiguity guard), read on the date above. Ubiquiti and UniFi are trademarks of Ubiquiti Inc. VoqadoWiFi is not affiliated with or endorsed by either vendor.

Get the free Guest WiFi Launch Pack

Four worksheets for switching guest WiFi on at your venue: a network inventory, a launch acceptance checklist, a change window plan and a staff handoff. Works for Omada and UniFi setups.

4 files, ready to download on this page. No account needed.

Run your UniFi portal free One location and 500 guest logins a month on the Starter plan, no card. The dashboard prints the finished portal URL for this controller. Create your free account