Skip to main content

BIG GUIDE: Setting up Spotipo hotspot with Unifi devices (NEW UI)

Rakesh M avatar
Written by Rakesh M
Updated this week

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:

  1. Go to Console Settings in the UniFi UI.

  2. 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. If you're using Officially hosted Unifi servers

  • Get the direct URL to your Server

  • Login to your UniFi Cloud controller and use the Copy Inform URL option to get the INFORM URL for your APs.
    ​


    It will look something like http://xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx.unifi-hosting.ui.com:8080/inform
    Hostname part of the URL would be your server address! In this case xxxxx-xxxx-xxxx-xxxx-xxxxxxxxxx.unifi-hosting.ui.com

3.4. Allow Spotipo Servers Through Your 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

  1. Controller IP/Host name:

  2. Self-hosted (Linux, Windows, Docker): Use port 8443 (if public IP) or 443 (if using a reverse tunnel).

  3. UniFi OS devices: Use port 443.

  1. Enter your admin credentials (local account for UniFi OS, UI.com for standalone controllers).

  2. Click Next.

4.4. Configure SSID for Hotspot

  1. Select the SSID where you want to enable the hotspot.

  2. 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.

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.


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

Optional: Payment login

q.stripe.com
js.stripe.com
api.stripe.com

Optional: Facebook login

facebook.com
akamaihd.netakamai.net
edgecastcdn.net
facebook.net
akamaihd.net
fbcdn.net
atdmt.com
fbsbx.com

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.

Did this answer your question?