BIG GUIDE: Setting up Spotipo hotspot with Unifi devices (NEW UI)
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. If you're still using the old user interface, check our documentation here.
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.
For UniFi OS devices, enable remote access to allow Spotipo to connect:
Go to Console Settings in the UniFi UI.
Enable Remote Access.
Spotipo requires access to your UniFi controller to authorize guests and collect stats.
To allow this, configure the following:
Set up port forwarding on your ISP router for port 443 to your UDM's WAN IP.
Guides: Port Forwarding
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
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.
Guides: Allow Spotipo servers through your UniFi firewall | Configure Unifi Zone Based Firewall to work with Spotipo
Navigate to Settings -> UniFi Settings
Click on the settings icon to configure the controller.
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".
If you have a public IP: Select Direct Connection.
If you don’t have a public IP: Use Reverse Proxy and follow this guide.
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.
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."
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. If you're still using the old user interface, check our documentation here.
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.
Guides: Allow Spotipo servers through your UniFi firewall | Configure Unifi Zone Based Firewall to work with Spotipo
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."
Updated on: 27/05/2025
Thank you!