TP-Link Omada controllers provide enterprise-grade WiFi management at accessible prices, making them popular for small to medium businesses. By integrating Spotipo's external portal with your Omada setup, you can transform basic guest WiFi into a customer engagement platform—collecting emails, offering social login options, and enabling paid WiFi access.
This guide walks you through setting up your TP-Link Omada controller to work with Spotipo's cloud authentication system. The setup requires an FQDN with valid SSL certificate and takes approximately 30-40 minutes to complete.
What you'll accomplish:
Set up Omada controller with external RADIUS authentication
Configure SSL certificate and FQDN for secure portal access
Create guest WiFi with email capture and social login
Enable bandwidth accounting and guest access control
What you'll need:
TP-Link Omada controller (hardware or software-based)
Domain name or subdomain pointing to your controller
Valid SSL certificate for your domain
Active Spotipo account (start free trial)
Important requirement: Omada controllers must have an FQDN (fully qualified domain name) and valid SSL certificate for external portals to function properly. This is an Omada platform requirement, not a Spotipo limitation.
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.
app.spotipo.com logme2wifi.com <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
js.stripe.com api.stripe.com q.stripe.com
For facebook login, add below as IP ranges
129.134.0.0/16 157.240.0.0/16 173.252.64.0/18 179.60.192.0/22 185.60.216.0/22 204.15.20.0/22 31.13.24.0/21 31.13.64.0/18 45.64.40.0/22 66.220.144.0/20 69.63.176.0/20 69.171.224.0/19 74.119.76.0/22 103.4.96.0/22
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.
Your TP-Link Omada Controller Is Now Connected to Spotipo
Once your setup is complete and the splash page appears correctly, guests will authenticate seamlessly—and you can start capturing WiFi guest data, running marketing campaigns, or offering paid WiFi access through your Omada network.
What to do next:
Customize your splash page design in Spotipo dashboard to match your branding
Set up email marketing integrations to automatically sync guest contacts
Configure paid WiFi packages to generate revenue from premium access
Common Omada setup issues:
Portal not appearing: Verify your FQDN is in the Pre-Authentication Access list
SSL certificate errors: Ensure your certificate matches your FQDN exactly
Authentication failures: Check that RADIUS secret matches Spotipo settings (case-sensitive)
Still having trouble with your TP-Link Omada setup? Contact Spotipo support via live chat or email us at [email protected]—we'll help troubleshoot your specific Omada controller configuration.