1. Home
  2. Devices & Hardware
  3. Ubiquiti UniFi Cloud Controller

Ubiquiti UniFi Cloud Controller

This article describes installation and configuration steps for Ubiquiti UniFi Cloud Controller ( v5.7 or above). Our test was performed with V5.9.29 controller and Unifi AP-AC-Lite v4.0.9.9639.


Log in to your UniFi controller and click the Setting icon.

Create a Wireless Network that will be enabled for Guest Access.
Go to Settings / Wireless Networks, click Create New Wireless Network and configure following:

Name/SSID: Your SSID ( it’s your choice what will be set as SSID Name, Guest WiFi in our case)
Enabled: Enabled
Security: Open
Guest Policy: Enabled

Click Save to apply changes.

Go to Guest Control page and on the Guest Policies section set following:

Enable Guest Portal: Enabled
Authentication: Hotspot
Default Expiration: 8 Hours
Landing Page: Promotion URL – insert desired URL
Use Secure Portal: Disabled
Redirect using hostname: Disabled
Enable HTTPS Redirection: Disabled

Configuring parameters

On the Portal Customization section as Template Engine set Angular JS and enable Override Default Templates.
Enable RADIUS on the Hotspot section.
Go to Profiles / Radius page.
Click Create New RADIUS Profile and configure following:

Profile Name: Test
RADIUS Auth Server:
Port: 1812
Password / Shared secret: (contact our office)
Click Add Auth Server and configure Radius server 2:
RADIUS Auth Server:
Port: 1812
Password / Shared secret: (contact our office)
Accounting: Disabled

Save changes.

On the Access Control / Pre-Authorization page enter the Walled garden IP’s.


If you want to enable Social network login feature, add further IP’s as per below for each network you plan to support.

Please note, these IP ranges are subject to change depending on the social network setup.

– if it does not work,  try adding:
Facebook app setup instructions


– if it does not work,  try adding:
LinkedIn app setup instructons

Apply changes to save.

At the end, you will need to modify two html files on the controller so that it correctly redirects and authenticates.

Last, very important step:
Download this file and unzip it in your Unifi controller hotspot directory.
Depending of the OS, it is usually located at the location bellow:

Windows: C:\Users\\Ubiquiti UniFi\data\sites\default\app-unifi-hotspot-portal
MAC: ~/Library/Application Support/UniFi/data/sites/default/app-unifi-hotspot-portal
Linux: /usr/lib/unifi/sites/default/app-unifi-hotspot-portal

If your Unifi controller is different version, you should be ok to extract and replace only index.html and auth.html files from this archive.

If you need help with configuration, please go to starthotspot.com and contact our tech support. We’ll be glad to help you.

Updated on March 18, 2019

Was this article helpful?