Question 1

How to configure Unifi controller with self hosted Spotipo

Accepted Answer

Add a Site

Each location is represented by a Site. A site can have multiple routers (of the same type)

After adding the client add a new site by clicking on the button in the drop down menu on top right.

Select the client you have just created, Site type as Unifi and configure the correct timezone and Save

Activate Site

Next step is to activate the site and choose a subscription. Please follow this.

Configure Unifi Controller Settings

Go to Dashboard -> UniFi -> Unifi Management

Enter there details of your Unifi Controller/ Cloud Key and press Save

Select the Unifi Site

After activation, go to the site and select the Settings tab.

There select the name of the Unifi site you want deploy hotspot under Site ID

Enable Guest Settings with External Portal

Enable Guest Policy for the correct WiFi Network

![](https://st

Question 2

How to fix ImportError: cannot import name _remove_dead_weakref

Accepted Answer

Full Error Print

Traceback (most recent call last):
File "/usr/share/nginx/spotipo/.env/bin/pip", line 7, in
from pip import main
File "/usr/share/nginx/spotipo/.env/local/lib/python2.7/site-packages/pip/init.py", line 5, in
import logging
File "/usr/lib/python2.7/logging/init.py", line 26, in
import sys, os, time, cStringIO, traceback, warnings, weakref, collections
File "/usr/lib/python2.7/weakref.py", line 14, in
from _weakref import (
ImportError: cannot import name _removedeadweakref
dpkg: error processing package spotipo (--configure):
installed spotipo package post-installation script subprocess returned error exit status 1
Errors were encountered while processing:
spotipo
E: Sub-process /usr/bin/dpkg returned an error code (1)

This error is usually seen while upgrading/installing spotipo. It might be caused by a recent OS upgrade.

Solution to ImportError: cannot import name removedead_weakref

This error can be solved usually by removing the exisiting virtualenv and letting the installer create a new one.

Please follow below steps

sudo apt remove spotipo sudo rm -rf /usr/share/nginx/spotipo/.env sudo apt install spotipo

Question 3

How to configure Unifi controller with Spotipo Cloud

Accepted Answer

Prepare your Controller

Make sure that your controller is reachable from internet over port 8443. Please identify the external IP of your controller, enable port forwarding if necessary.

|| Check if you are able to access unifi controller interface by going to https://YOURCONTROLER IP:8443

If you want to know the IP addresses used by spotipo cloud check this link.

Configure UniFi Controller Details in Spotipo

|| Please make sure your unifi controller is reachable from internet on port 8443 before following this.

On the left tab, select Unifi Controller option. Fill in the IP, Username and Password of your controller and press Save.

|| You will need to enter Super admin credentials

Next step select the Unifi site in which you want to enable Spotipo and press save.

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.

Question 4

How to fix  " The domain of this URL isn't included in the app's domains. "

Accepted Answer

If you are using Spotipo to enable facebook login on your guest wifi, you might run into the below error.

Can't load URL: The domain of this URL isn't included in the app's domains. To be able to load this URL, add all domains and sub-domains of your app to the App Domains field in your app settings.

This happens when there is mismatch on the URL configured on your facebook app and the URL to which Guests are redirected. Debugging this is quite simple.

Ensure that SSL is enabled

Facebook has mandated that all Apps should be using SSL. If you haven't already, please enable SSL on your Spotipo installation.

Get the full URL when you see this error

If you are getting this error on a mobile device captive network assistant, it's not possible to copy the URL. In such case either connect a laptop to your network or close the captive portal and use a normal browser.

Decode the URL content

Use a decoder like https://www.urldecoder.org/ paste the full URL into the box and press decode.

**Inspect the URL content and figure out the Redirec

Question 5

How to capture Guest email addresses in UniFi

Accepted Answer

Learn how to use Spotipo to capture email address from guests logging into your UniFI wifi network. Email along with other guest details will be stored in the database which can then be exported as CSV file.

Signup for Spotipo and create a site

You can sign up for an account here. We offer 15 Day free trial.

Configure Email collection

In Spotipo, email collection is enabled by default.

Configure UniFi to use Spotipo as external portal

Spotipo works as an external captive portal for UniFi. Learn How to configure Unifi controller with Spotipo Cloud

Question 6

How to install Spotipo on Ubuntu/Debian

Accepted Answer

||| Unfortunately we have stopped accepting new customers for self hosted version. Hence this article is not usable unless you already had purchased a spotipo license. Please checkout our cloud offering instead.

|| This article will show how to install Spotipo on your system step by step. Do read the Requirements first.

Connect to your Server via SSH

Follow the instructions by your server provider to provision an Ubuntu server, we recommend Ubuntu 16.04 x64 as the OS. Once its ready, connect to the server using your favorite SSH tool. You can follow this guide on SSH.

After logging in, first add the public keys used to sign spotipo packages.

sudo apt-key adv --keyserver keys.gnupg.net --recv-keys 76634F92039C47F3

If the above step fails. please try below command instead

sudo apt-key adv --keyserver hkp://keyserver.ubuntu.com:80 --recv 76634F92039C47F3

Add spotipo repository

Ubuntu 16.04+ and Debian 7/8

echo "deb http://repo.spotipo.com/ ubuntu main" | sudo tee --append /etc/apt/sources.list
sudo apt update
sudo apt install spotipo

Debian 9+

echo "deb http://repo.spotipo.com/ debian stretch" | sudo tee --append  /etc/apt/sources.list
sudo apt update
sudo apt install spotipo

If you get an error saying install dirmngr using the command

If prompted, set a password for MySQL server. Be sure to remember it as it will be needed i

Frequently Read Articles

Browse All Categories