Help Center

Ubiquiti Unifi

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



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. The access points need to have firmware 4.0.54 or later.

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

You may choose to configure the device to automatically receive and install last firmware updates.

You will require a RADIUS password and a Custom URL from the SpotOn Support team. Chat with us, send an e-mail ([email protected]) or give us a call (050 211 5201).


SSID setup

To set up your SSID, go to Settings > Wireless Networks and create or edit your wireless network with the following settings. Make sure to check the “Apply guest policies (captive portal, guest authentication, access)”

create network2 1024x158 - Ubiquiti Unifi

ssid settings2 1024x297 - 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: uncheck all options.

Screenshot on 2019 11 01 at 10 56 26 1 - Ubiquiti Unifi


Portal Customization

Find the PORTAL CUSTOMIZATION tab and set:

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

Screenshot on 2019 11 01 at 10 56 53 - Ubiquiti Unifi

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

Screenshot on 2019 11 01 at 10 56 53 - Ubiquiti UnifiScreenshot on 2019 11 01 at 10 57 37 - Ubiquiti Unifi

RADIUS server configuration

Scroll down to the RADIUS-tab.

To set up your SSID, click on Create new RADIUS profile and create your RADIUS server configuration.

Annotation on 2019 11 01 at 11 08 01 - Ubiquiti Unifi

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 below:

RADIUS Auth-server

IP-address: ; Port: 1812

RADIUS Accounting Server

IP-address: ; Port: 1813

RADIUS password / Shared Secret:

Ask the SpotOn team for the RADIUS password

radius settings - Ubiquiti Unifi

Save your new Radius Profile.

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

Screenshot on 2019 11 01 at 10 57 56 - Ubiquiti Unifi


Pre-Authorization Access (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.

Screenshot on 2019 11 01 at 11 30 02 - Ubiquiti Unifi

Under Site, enable Auto-Optimize Network.

Screenshot on 2019 11 01 at 11 22 07 - Ubiquiti Unifi

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


Custom URL

Ask the SpotOn team for your custom URL.

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.


Can't find your answer?