UniFi Installation

Installing Beambox on your UniFi cloud controller

Libby Anderson avatar
Written by Libby Anderson
Updated over a week ago

NOTE: This installation guide is based on UniFi controller version 6.1.71, however, Beambox is compatible with all controller versions.

Installing Beambox on your UniFi controller is quick and easy. It takes just a few minutes to get started and add your WiFi login to the UniFi site and network that you select.

Preparing your UniFi controller

Beambox requires your UniFi controller to be remotely accessible. This cannot be a local-only controller or a cloud-access account. This is important, as our integrator has to be able to reach your controller at all times to authorise your guests.

There are a few options to launch your cloud controller...

1. Use Hubox.co to quickly deploy a managed cloud controller in just a few minutes
2. Port-forward your existing controller. For UniFi OS controllers, port forward 443. For all other controllers, port forward 8443, a static Public IP is needed for Port-forward.
โ€‹3. Setup DDNS in case a static public IP is not available.
4. Self-deploy for free using the official UniFi guide (advanced)

Note: If you are port forwarding a UniFi OS controller such as a UDM Pro, please use the "WAN Local" firewall rules.

Port Forwarding

Most commonly, venues port forward their existing hardware to make their controller remotely accessible. This is a pretty easy thing to do and if you don't know how we recommend searching "How to port forward on *your router make/model*".

If when logging in your controller says "UniFi OS", you should port forward 443 and then your controller URL will be in the format https://YOUR_PUBLIC_IP:443.

For all other UniFi controllers, port forward 8443 and your controller URL will be in the format https://YOUR_PUBLIC_IP:8443.

Remember, we can help out with this if you get stuck!

Activating your UniFi integration

Beambox will automatically configure the guest portal settings, using the 'Guest Hotspot' feature in your UniFi WiFi settings. After a successful login, Beambox will then authenticate the guest's device on your dashboard at lightning speed โšก๏ธ

After signing up for a trial, you will be presented with the Beambox UniFi integrator on your dashboard. You'll need to complete 3 fields:

  • Controller URL - This is the hostname or IP that you use to reach your controller. You should be able to reach your controller by entering this URL in your browser.

  • Username - The username for an admin account on your UniFi controller.

  • Password - The password for an admin account on your UniFi controller.

Once entered select 'Load Sites' and select the site that you want to activate Beambox on. Your guest control settings will only be configured for this site. Click 'Activate Beambox' to finish your integration.

Enabling Beambox on a wireless network

Now that we have successfully completed the integration, the only thing left to do is to enable the external portal that we have added to one of your WiFi networks.

In your WiFi settings, select the guest SSID that you have created and make sure you have the following:

  • Hotspot Portal - โœ…

And that's it! You can now test out your wireless network and see Beambox in action.


Need help?

Don't panic! Our team are UniFi experts and can help you navigate any setup issues you may be facing. First of all, use the button below to check out our most common UniFi setup issues.

Did this answer your question?