Help Center

Ubiquiti Unifi

This guide shows how to configure an Ubiquiti Networks managed controller in order to integrate access points with SpotOn.

Important Notice

When a Cloud Key is used it’s important to upgrade the your Cloud Key to the latest firmware. After this, upgrade the version of UniFi controller to it’s latest stable version 5.11.39. However, Ubiquiti works with a soft-launch, so during the first 1 or 2 weeks you can only manually update to this latest version. After this period you can update from UniFi or Linux to the latest version yourself.

To update to 5.11.39 you must log in to the controller with SSH. Use these commands:

cd /tmp
sudo wget
sudo dpkg -i unifi_sysvinit_all.deb
sudo rm unifi_sysvinit_all.deb

(NOTE: This link only applies to the Cloud Key and Debian / Ubuntu Linux controllers. For Other operating systems, the link must be copied from this page:

After updating, the firmware of the access points can be updated to 4.0.54. In addition, a new option must be deselected to supplement the manual on the Spoton website.
The option is on the “Guest Control” page and is called: “Enable encrypted redirect URL”. This must therefore be switched off, see figure:

PastedGraphic 1 - Ubiquiti Unifi



This article applies to Ubiquiti Unifi SDN Controller with Firmware release 5.11.39 or later versions. It is required to work with these versions to be fully compatible with SpotOn.

To correctly integrate Ubiquiti Networks devices, it is necessary that:

  • the controller is up and running at configuration time
  • the controller is up and running when you are providing the service to your guests
  • client devices must reach the controller at port 8080, 8880 and 8443, by using a public IP address (These ports do not have to be open for outside, only the Unifi APs must be able to connect to the controller on these ports)
  • Required controller files are available for download in the portal OR Contact Support

To use these access points, it is necessary for the router to be connected to the Internet.
It is recommended to update your device firmware to the last available version.
You may choose to configure the device to automatically receive and install last firmware updates.


Unpack and copy the ZIP-file

In order to correctly redirect guests to our Splash Page, it is necessary to download the controller files onto the controller server.

-> Download the ZIP-file

Before downloading the controller files, you need to check your settings. Log in to the Unifi Controller web UI, go to SETTINGS > GUEST CONTROL; find the PORTAL CUSTOMIZATION tab and set:

  • Template Engine: “AngularJS”
  • Override Default Templates: “Override templates with custom changes”

angular - Ubiquiti Unifi

Note: It is important to do this action before downloading the controller files. Otherwise, the destination path for your files might not be available.

After this step, you can extract the controller files. The destination path depends on the OS which hosts your Controller.

  • If your system is Linux, extract the archive to /usr/lib/unifi/data/sites/default/app-unifi-hotspot-portal
  • If your system is Mac, extract the archive to ~/Library/Application Support/UniFi/data/sites/default/app-unifi-hotspot-portal
  • If your system is Windows, extract the archive to Ubiquiti UniFi\data\sites\default\app-unifi-hotspot-portal

After completion check if spoton_unifi.js contains the Custom URL to our Splash page. *Contact the SpotOn team to recieve your Custom URL.

var spotonPortal="PLACE_CUSTOM_URL_HERE";

In case you have a Cloud Key:

  • Restart the Cloud Key and extract the ZIP-zip file
  • Download WinSCP for CK’s file system inspection, at
  • Select SFTP protocol, port 22 for configuring the file transfer.
  • After accessing the file system, go to /srv/unifi/data/sites/<site_name>/app-unifi-hotspot-portal (for example, in case the Default site is being used the correct path is /srv/unifi/data/sites/default/app-unifi-hotspot-portal)
  • Please rename the old index.html file to index.html.default before proceeding with the override and copy the extracted files there.
  • Ensure that the ownership of files belongs to user unifi and group unifi.
SSID setup

To set up your SSID, go to Settings > Wireless Networks and create or edit your wireless network.

create network - Ubiquiti Unifi


ssid settings - Ubiquiti Unifi

RADIUS server configuration

To set up your SSID, go to Settings > Profiles and create or edit your RADIUS server configuration.
It is necessary to check Enable accounting and Enable Interim Update, and set RADIUS Auth Server and RADIUS Accounting Server accordingly with the data specified in the “Parameters for the Solution” paragraph.

new radius profile - Ubiquiti Unifi
radius settings - Ubiquiti Unifi

Hotspot configuration

Go to Settings > Guest Control.


Splash Page

Find the Guest Policies tab and configure the options as follows:

  • Guest Portal: check the “Enable Guest Portal” option.
  • Authentication: Hotspot
  • Redirection: check only the “Enable HTTPS Redirection” option.

guest control policies - Ubiquiti Unifi

Find the Hotspot tab, check Enable RADIUS-based authorization and uncheck all the other options.

guest control policies 2 - Ubiquiti Unifi

Find the RADIUS tab and configure the options as follows:

  • Profile: (select the profile name you set up in the previous step)
  • Authentication type: CHAP

guest control policies 3 - Ubiquiti Unifi

Walled Garden

Under Guest Control tab go to Pre-Authorization Access section and enter here your required entries. The following ones are required for the proper functioning of the system.

walled garden - Ubiquiti Unifi

Parameters for the Solution

The parameters indicated above for the Mode Settings section are mandatory for the proper functioning. The necessary parameters to integrate the device with the Solution are the following:

RADIUS Auth-server
IP-address:; Port: 1812


RADIUS Accounting Server
IP-address:; Port: 1813

RADIUS password / Shared Secret:

[email protected]


Custom URL

Ask the SpotOn team for your custom URL.

Can't find your answer?