Welcome to Purple Support

Ubiquiti UniFi Controller (Legacy)

  • Updated
This guide is only for older UniFi controllers and shouldn't be used for new setups. If you are running v7.0 or above, please choose the newer Ubiquiti UniFi Network Controller hardware type instead.


You need to disable the new UI until you've set everything up. To do so, click the Setting icon and go to System > Advanced, then set the Interface to Legacy.

Log in to your UniFi controller and click the Setting icon (bottom left).

On the left menu, under Wireless Networks click Create New Wireless Network and configure with:

  • Name/SSID: Guest WiFi (or whatever you wish)
  • Enabled: Enabled
  • Security: Open
  • Guest Policy: Enabled

Click Save to apply. Next, click on Guest Control configure with:

Under the Guest Policies header:

  • Enable Guest Portal: Enabled
  • Authentication: Hotspot
  • Default Expiration: 8 hours
  • Landing Page: Promotion URL - *insert redirect_url here*
  • Use Secure Portal: Disabled
  • Redirect using hostname: Disabled
  • Enable HTTPS Redirection: Disabled
  • Enable encrypted redirecet URL: Disabled


Under the Portal Customization header:

  • Template Engine: AngularJS
  • Override Default Templates: Enabled


Under the Hotspot header:

  • RADIUS: Enabled


Under the RADIUS header:

Profile: click Create New RADIUS Profile and configure with:

  • Profile Name: guestwifi
  • RADIUS Auth Server: *insert radius_server_ip here*  Port: 1812  Password: *insert radius_secret here*
    click Add Auth Server and configure with:
  • RADIUS Auth Server: *insert radius_server2_ip here*  Port: 1812  Password: *insert radius_secret here*
  • Accounting: Add the same servers as above, but with port 1813.

   Click Save to continue.

  • Authentication type: CHAP

Under the Access Control > Pre-Authorization header enter the following IP:

  • *insert walled_garden_ip here*

If you wish to support social network logins, you also need to add further IP's as per below for each network you plan to support





NOTE: These IP ranges are subject to change depending on the social network setup.


Click Apply Changes to save.


Finally, you will need to modify two html on the controller so that it correctly redirects and authenticates. First of all, download the below two files:

Open the index.html file and at the top of this document you will see an item named "splashurl": Edit this so that it shows:


var splashurl = "*insert access_url here*";


Now, you need to copy these two html files to your UnifFi controller hotspot directory. This is typically located at the below location:

  • Windows: C:\Users\<username>\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/data/sites/default/app-unifi-hotspot-portal
  • UDM Pro: /data/unifi/data/sites/default/app-unifi-hotspot-portal
  • CloudKey: /srv/unifi/data/sites/default/app-unifi-hotspot-portal

(replace default in the folder structure with your site name if different)


If the sites folder is not present, you can created it by simply uploading a floorplan (even a dummy one if required) in the UniFi controller which will create the folder you need. 



Share online:
Was this article helpful?
0 out of 0 found this helpful