This guide explains how to set up your UniFi device with Spotipo, including configuring local admin access (for UniFi OS devices only), enabling remote access, and setting up firewall rules (for UniFi gateways only).
While this guide details firewall setup for UniFi devices, the specified IP addresses should also be allowed through any other firewalls in your network.
This guide is written to reflect Spotipo's new User interface.
1. Creating a Local Admin
First, you need to create an administrator account that doesn't require Multi-factor Authentication. Learn how to do this below.
* Guides: Add local admin to UniFi controller.
2. Enable Remote Access (UniFi OS Devices Only)
For UniFi OS devices, enable remote access to allow Spotipo to connect:
Go to Console Settings in the UniFi UI.
Enable Remote Access.
3. Making your UniFi visible to Spotipo
Spotipo requires access to your UniFi controller to authorize guests and collect stats.
To allow this, configure the following:
3.1. If Your Unifi Controller Is Behind a Router
Set up port forwarding on your ISP router for port 443 to your UDM's WAN IP.
Guides: Port Forwarding
3.2. If you don't have a static public IP
If you don’t have a static public IP We recommend using our Service of setting up Reverse tunnels. But you could also use DDNS.
Guides: Reverse Tunnel | DDNS
3.3. Allow Spotipo Servers Through Your Firewall
Next, if you're using devices such as UDM, UDM-Pro, UXG-Pro, and similar UniFi Security Gateways. You'll have to allow spotipo servers access to your controller. Learn more by checking the articles below, depending whether you're using legacy or zone-based firewall.
4. Configuring UniFi Controller in Spotipo
Navigate to Settings -> UniFi Settings
Click on the settings icon to configure the controller.
4.1. Select the Right Setup Type
If your controller is self-hosted (Linux, Windows, Docker, etc.): Select "Set installed software".
If your controller is a UniFi OS device (UDM, Cloud Key, UX, etc.): Select "UniFi OS".
4.2. Connection Type
If you have a public IP: Select Direct Connection.
If you don’t have a public IP: Use Reverse Proxy and follow this guide.
4.3. Enter Controller Details
Controller IP/Hostname:
Self-hosted (Linux, Windows, Docker): Use port 8443 (if public IP) or 443 (if using a reverse tunnel).
UniFi OS devices: Use port 443.
Enter your admin credentials (local account for UniFi OS, UI.com for standalone controllers).
Click Next.
4.4. Configure SSID for Hotspot
Select the SSID where you want to enable the hotspot.
Spotipo will automatically configure the Guest Policy.
Verify that the controller is connected by returning to the Unifi controller tab, and the status shows "Online."
5. Configure Hotspot Settings in Unifi
Now that controller is connected to Spotipo, all you have to do is to check the hotspot settings on Unifi controller itself.
On your Unifi controller, go to Insights -> Hotspot -> Landing Page
From there, make sure that under Authentication there is a box checked beside External Portal Server section and that the address entered is 107.178.247.148
Once that is set, move on to captive portal settings and copy the following:
Domain: app.spotipo.com
Authorization access:
app.spotipo.com
107.178.247.148
q.stripe.com (optional: payment login)
js.stripe.com (optional: payment login)
api.stripe.com (optional: payment login)
facebook.com (optional: facebook login)
akamaihd.netakamai.net (optional: facebook login)
edgecastcdn.net (optional: facebook login)
facebook.net (optional: facebook login)
akamaihd.net (optional: facebook login)
fbcdn.net (optional: facebook login)
atdmt.com (optional: facebook login)
fbsbx.com (optional: facebook login)
5.1 Check wifi settings
Once that is done all that is left to do is to check if the captive portal is turned on for your desired wifi.
Navigate to Settings -> WiFi -> Your WiFi Name
From there, set the Advanced settings to manual and under Hotspot 2.0 set it to Captive portal.
6. Test Things out
All that is left to do now is to test the captive portal out.
If you run into some issue, feel free to contact us through chat, or by writing to us at [email protected]. We'll gladly help you out.