Configuring your UniFi Cloud Key with Spotipo's captive portal transforms your guest WiFi into a customer engagement platform with email capture, social login, and paid access capabilities. This integration connects your Cloud Key to Spotipo's cloud authentication system, enabling advanced guest management features while maintaining UniFi's reliable network performance.
This guide walks you through the complete setup process for UniFi Cloud Key devices, including controller configuration in Spotipo, guest control settings in UniFi, and SSID-level guest policy activation. The setup takes approximately 15-20 minutes and works with all UniFi Cloud Key generations.
What you'll accomplish:
Connect your UniFi Cloud Key to Spotipo with admin credentials
Configure external portal authentication in UniFi guest control settings
Set up pre-authorization access for Spotipo servers
Enable guest policy on your WiFi SSID
What you'll need:
UniFi Cloud Key (Gen1, Gen2, or Gen2 Plus) with admin access
Public IP address or reverse tunnel capability for remote access
Active Spotipo account (start free trial)
Admin credentials for your UniFi controller
Important: Your Cloud Key must be accessible from Spotipo's servers. Ensure you have a public IP or configure reverse tunnel access before starting this setup.
Configure UniFi Controller Details in Spotipo
On the left tab, select the Unifi Controller option.
In the beginning, no controller is configured; therefore, the status shows "not configured, Click on the settings button.
Select the controller Unifi Cloud Key and click Next.
Ensure all the points mentioned in the checkbox have been verified already.
Enter credentials to the controller and click Next.
Enter the Unifi site in which you want to enable Spotipo and press Finish.
It can be verified if the controller is connected by going back to the Unifi controller tab, where status 'Online' is shown.
Configure Unifi controller Guest Control Settings
Now log into your Unifi controller and navigate the correct site. Select Guest Control tab and configure the following
Enable Guest Policy
Select Authentication as External Portal server
Under Custom portal, enter IP address as 107.178.247.148
Enable Use Secure Portal
Enable redirect using hostname and enter it's value as logme2wifi.com
Add the following entry to Pre Authorization Access 107.178.247.148/32
Enable Guest Policy on your SSID
Last step is to enable the Guest policy on the SSID
Your UniFi Cloud Key Is Now Connected to Spotipo
Once you've completed the controller configuration in Spotipo, set up guest control settings in UniFi, and enabled guest policy on your SSID, your captive portal is ready. Guests connecting to your WiFi will be redirected to Spotipo's authentication page—and you can start capturing guest data, running marketing campaigns, or offering paid WiFi access.
What to do next:
Test the captive portal by connecting a device to your guest WiFi network
Verify your controller status shows "Online" in Spotipo settings
Customize your splash page design to match your branding
Set up email marketing integrations to automatically sync guest contacts
Common UniFi Cloud Key setup issues:
Status shows "Not Configured": Click the settings button to begin controller configuration
Controller not reachable: Verify your Cloud Key has a public IP or reverse tunnel configured
Authentication failures: Ensure admin credentials have proper permissions (consider creating a dedicated local user)
Portal not appearing: Check that 107.178.247.148 is in Pre Authorization Access list and the external portal server is enabled
Guest control configuration checklist:
✓ Guest Policy enabled
✓ Authentication set to "External Portal Server"
✓ Custom portal IP: 107.178.247.148
✓ Use Secure Portal enabled
✓ Redirect using hostname: logme2wifi.com
✓ Pre Authorization Access includes 107.178.247.148/32
Multi-site UniFi controllers: If your Cloud Key manages multiple sites, you'll need to select the correct site during Spotipo configuration. Each site can have different Spotipo configurations, allowing you to manage multiple locations with distinct splash pages and settings.
Still having trouble configuring your UniFi Cloud Key? Contact Spotipo support via live chat or email us at [email protected], we'll help troubleshoot your specific Cloud Key setup and connectivity issues.