Router:Ubiquiti Unifi Cloud Gateway

From AAISP Support Site
Revision as of 08:47, 13 August 2025 by Suggestable (talk | contribs) (New page. Based on existing USG page. WIP.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

The Ubiquiti UniFi Cloud Gateway series of devices can be used as a router (with a suitable modem) with A&A’s services. Other UniFi Cloud Gateway versions should also work. The UniFi Cloud Gateway Fibre router used in these examples is based on a quad-core ARM64 processor running a modified Linux distribution.

You’ll need

Configuration

Unifi1.png

It is possible to achieve a working configuration using the Unifi Controller web interface, although access to the UCG via SSH is helpful for debugging where necessary.

Connect to the Unifi Controller via a browser. Under Settings -> Networks, select the WAN network. Set:

  • IPV4 Connection Type: PPPoE
  • Username and password: As supplied by A&A
  • IPV6 Connection Type: Using DHCPv6
  • Prefix Delegation Size: As shown on the A&A Configuration Page (usually 64)


Unifi2.png

Select Save and then navigate to the Devices section of the Unifi Controller. When the Cloud Gateway status changes from Getting Ready to Connected, then Restart the Cloud Gateway by selecting Restart at the right of the screen. You must restart your Cloud Gateway for changes to take effect.


You can test the configuration by connecting to the Unifi Security Gateway by SSH and running the following commands:

show ipv6 route
show interfaces
ping6 google.com 
Unifi3.png

At this point if you have not already done so, you should configure IPv6 on your LAN, by navigating to Settings -> Networks -> LAN. Under Configure IPV6 Network set:

  • IPv6 Interface Type: Prefix Delegation
  • IPv6 Prefix Delegation Interface: WAN
  • IPv6 Prefix ID: Leave blank
  • All other settings as default

You can then test if your machine has an IPv6 address by running *ifconfig* (Linux/Mac) or *ipconfig* (Windows) and by visiting https://ipv6-test.com/