Spotipo's automated wizard configures UniFi controllers automatically, but understanding the manual configuration process helps troubleshoot issues, verify settings after updates, or configure controllers that can't use the wizard. This guide documents every setting the wizard configures, allowing you to replicate the setup manually.
This advanced guide walks through each UniFi controller setting required for Spotipo integration, from SSID hotspot portal enablement to pre-authorization allowances.
What you'll accomplish:
Enable hotspot portal on your target SSID
Configure external portal server with correct IP and domain
Set up secure portal with proper landing page settings
Add pre-authorization allowances for Spotipo and payment domains
What you'll need:
UniFi controller with Spotipo site already configured (Settings → UniFi Controller)
Admin access to UniFi controller interface
Understanding that settings may require AP restart to take effect
When to use manual configuration: Troubleshooting automated wizard issues, verifying settings after controller updates, or situations where the wizard cannot connect to your controller.
Before proceeding with this article, make sure you have configured your controller on Spotipo under Settings -> UniFi Controller.
Login to your UniFi controller and navigate to Settings -> WiFi -> Choose the SSID you want to enable the portal on.
Enable the Hotspot Portal Option here and press Save.
Once that's enabled, there will be Hotspot Manager tab that will be available on the left nav bar, click on it.
Under landing page -> Authentication, disable all options and enable only External Portal Server.
Now click the Edit button next to the external portal and use 107.178.247.148 as the portal address
Switch to the Settings tab and under Landing Page Settings, set the options as below
Enable Show Landing page
Enable Secure Portal
Enable Domain and use
app.spotipo.comas the domain
Under Pre-Authorization Allowances, enter below addresses
107.178.247.148app.spotipo.com
Additionally add below domains if you are collecting payments from Stripe.\
api.stripe.com
q.stripe.com
js.stripe.com
m.stripe.com
That's it, sometimes these settings will be reflected only after restating the APs
Enable hotspot portal on your target SSID
Configure external portal server with correct IP and domain
Set up secure portal with proper landing page settings
Add pre-authorization allowances for Spotipo and payment domains
What you'll need:
UniFi controller with Spotipo site already configured (Settings → UniFi Controller)
Admin access to UniFi controller interface
Understanding that settings may require AP restart to take effect
When to use manual configuration: Troubleshooting automated wizard issues, verifying settings after controller updates, or situations where the wizard cannot connect to your controller.
Manual Configuration Complete
After enabling hotspot portal, configuring external portal server settings, and adding pre-authorization allowances, your UniFi controller is manually configured for Spotipo. Restart access points if settings don't take effect immediately.
What to do next:
Restart access points to ensure settings propagate
Test captive portal by connecting a device to configured SSID
Verify all pre-authorization domains are correctly entered
Critical settings checklist:
External Portal Server IP: 107.178.247.148
Secure Portal domain: app.spotipo.com
Pre-auth includes: 107.178.247.148 and app.spotipo.com
Stripe domains added if using payment features
Still having configuration issues? Contact Spotipo support via live chat or email us at [email protected].