All Collections
Router Configuration
Configure TP-Link Omada controller
Configure TP-Link Omada controller

Learn how to configure Omada controller to work with spotipo.

Rakesh Mukundan avatar
Written by Rakesh Mukundan
Updated over a week ago

Add a Omada Site in Spotipo

Each location is represented by a Site. A site can have multiple routers (of the same type)

Go to Site Selector and use Create A New location button. Select the device type as Omada

Decide the type of Hotspot.

In the next step, choose what kind of hotspot you want to deploy. This can be later changed in Splash page settings. Press Save and create the site.

Get config from Spotipo.

After site is created, navigate to Settings -> Omada to get all the settings you need to configure your controller.


Assign an FQDN to your omada controller.

It's essential that your Omada controller needs to have an FQDN and a valid SSL certificate for the hotspot to work properly.

First, point your domain ( or sub-domain ) to your Omada controller's IP address, and then navigate to Controller -> Access Config inside your Omada controller.

Enter the FQDN as the Controller Hostname/IP, ( make sure that FQDN is pointing to your controller IP before doing this step)

Install the SSL certificate on your Omada Controller.

Under the HTTPS certificate section, upload your SSL certificate.

Create a Radius Profile for Spotipo in your Omada Controller

Add a new Radius profile under authentication tab on your site.

Here configure the details as per the settings from your Spotipo account.

  • Configure Authentication Server IP with Primary Radius value from Spotipo

  • Configure Authentication Password with Secret value from Spotipo

  • Enable Radius accounting

  • Enable Interim update and use 300seconds as the value

  • Configure Accounting Server IP with Primary Radius value from Spotipo

  • Configure Accounting Password with Secret value from Spotipo

Add a New Authentication Profile to your Omada site.

Now create a new portal config on the site where you like to deploy the hotspot on.

  • Enable Portal

  • Select the SSID on which portal needs to be enabled

  • Select the Authentication type as External Radius Server

  • Select the Radius profile we have just created

  • Configure the NAS ID with the "Identity" value from Spotipo

  • Enable disconnection requests

  • Set Portal customization as External Web Portal and select HTTPS copy the Splash URL from Spotipo there

  • Keep the landing page as Original URL

Configure Pre-Authentication Access

We need to configure Omada to allow guests to access the portal and related domains for the splash page to work.

Navigate to Authentication -> Portal and choose Access Control.

Here use the Add button and select the type as URL

Enter the below domains as a must and press Save.
<FQDN of your omada controller>

Optionally you would need to add below ones depending upon whether you want to enable payment processing or Facebook login.

For payment add below as URLs

For facebook login, add below as IP ranges

Wait and Test

Give Omada a few minutes to configure all APs and then connect a device to your WiFi network. You should be getting the splash page you just configured.

Did this answer your question?