Software Controller

There are a couple of installation options when it comes to software controllers. Pick the one that best describes your case:

Self-hosted (on your local server or cloud)

Ubiquiti recommends running the controller on a UniFi OS Console (Cloud Key, Dream Machine, etc.). If you want to self-host the controller, you can do it, but our support will be limited, due to the vast configuration possibilites.

More information about self-hosting the controller can be found here:

Make sure to enable SSH on your controller. If you do so, you can then connect via ssh and use the SCP method, it should be the same as in this article.

External company (Hostifi, Cloud UniFi etc.)

Sadly you won't be able to upload the files yourself. You will need to contact the people that manage the controller for you if they could upload the files. Reach out to them by sending an email message like this:


I would like to upload three files into the Controllers specific folder. They are hosted under this link: [ . They're needed for an external captive portal to work.

File path for index.html and auth.html: "/srv/unifi/data/sites/default/app-unifi-hotspot-portal".

For "/srv/unifi/data/sites/default/".

Kind regards,

<your name>

On your personal computer

Windows - Software Controller hosted on a local machine

We do not recommend nor support this way of setting up the Controller. The Controller should have a dedicated machine because it has to be online 24/7 for Social WiFi to work. However, if you know what you're doing, read the details below. If you don't, buy a UniFi OS console, like "UniFi Cloud Key Gen2" instead.

Remember that if you have more than one site the folder path may differ. If you want to configure Social WiFi on a specific site, the folder name of the site is in the web interface URL:

As you can see, after creating the site named "test1" the url has a path with "97f96w47", which is also the folder name for the site in the controller.

For example, here's the path to the "default" site:

C:\Users\<your_user_name>\Ubiquiti UniFi\data\sites\default\app-unifi-hotspot-portal

If we want to upload files to the "test1" site, the file path would be:

C:\Users\<your_user_name>\Ubiquiti UniFi\data\sites\97f96w47\app-unifi-hotspot-portal

In this guide, the files will be uploaded to the "default" site so the file path is:

C:\Users\<your_user_name>\Ubiquiti UniFi\data\sites\default\app-unifi-hotspot-portal

but the path may differ depending on where the software is installed.

Download the files from here. Uploading files in this case means drag and drop (or copy and paste) to the folder:

Last updated