UniFi ☁️ Installation with Cloud, UDM or UDR 📶 - New Interface

Please note if you have a UniFi Controller locally hosted or cloud key, please ensure the following ports are open on your firewall to allow the UniFi API to grant access to guest wifi users.

TCP 8080 Port used for device and controller communication.

TCP 8443 Port used for controller GUI/API as seen in a web browser

TCP 8880 Port used for HTTP portal redirection.
TCP 8843 Port used for HTTPS portal

Note: If you have a UDM or Cloud Key instead of 8443 please use port 443,

If you are using a Cloud Key device, please ensure the following is completed before you continue:
The above port are forwarded in your firewall rules to your Cloud Key (take note of the SSL note above)
The Cloud Key has a static internal IP address or has a DHCP Reservation
The ISP has a static external IP address
You have external remote access to the Cloud Key

Connect to your UniFi Controller via the web app or https://unifi.ui.com

Select Wireless Networks and press the + Create New button
We recommend adding a network name like the following _Business Name FREE WiFI, this will ensure your company will be displayed at the top of all other networks.
Select the "Manual" button
Hotspot Portal must be ticked✅
Client Device Isolation must be ticked✅
If your network doesn't have a super-fast connection and you'd like to give guests a speed limit, please click here to read our article on speed limitations.
Once the above information has been entered, please press "Add WiFi Network"

Please see the example below

Click on "Hotspot Manager" to complete the setup

It's located on the left menu see the image below

Now click the Landing Page option at the top of the page

Select the Authentication button and ensure External Portal Server ✅ is enabled.

Click "Edit" on External Portal Server and type in the following IP address 138.68.152.191

Click the "Settings" button to complete the setup (see example below)

Ensure all the boxes are selected ✅

Enter getonline.captivewifi.io for the Domain

Click "Add Hostname, IP or Subnet" and type in the following items.

getonline.captivewifi.io

captivewifi.fra1.digitaloceanspaces.com

138.68.152.191

captivewifi.io

kit.fontawesome.com

We recommend adding a separate LAN for this network; feel free to reach out to your IT Team, or if you need assistance, our support team can set this up for you in a few moments - click ➡️support@captivewifi.io This link will generate an email to our team.

If you encounter an SSL error or unsecured error while browsing, it is likely due to the controller or UDM not having a valid SSL. To resolve this issue, please update the settings on the UniFi landing page to the following:

Landing Page Settings: Show Landing Page: HTTPS Redirection Support Encrypted URL: Secure Portal: Domain:	Checked Unchecked Unchecked Unchecked Checked
Domain	connected.captivewifi.io

Please also add connected.captivewifi.io to the pre-authentication access

Note: you will need the direct IP or URL for the controller to enable the UniFi API to authenticate guests to your WiFi,
Please do not use https://unifi.ui.com as the URL this will not work, please ensure that port forwarding is enabled to the UniFi platform

Once Logged in to the Captive WiFi Dashboard
Visit Integrations

WiFi Hardware
Select UniFi Automated, add the login credentials for the UniFi solution
Once confirmed, this will populate all MAC Addresses and the Site ID

The Login credentials must be a local admin user to the controller, UDM or cloud key (not with an email address) as MFA is soon to be enabled with UniFi.

NOTE: For the UniFi URL this needs to be the external URL Hostname or IP Address. Please do not add a (forward slash /) at the end of the URL