What is it?¶
Unifi Controller software is a powerful, enterprise wireless software engine ideal for high-density client deployments requiring low latency and high uptime performance.
sb install sandbox-unifi
- To access Unifi Controller, visit
Visit the Unifi Controller site at
For Unifi to adopt other devices, e.g. an Access Point, it is required to change the inform IP address. Because Unifi runs inside Docker by default it uses an IP address not accessible by other devices. To change this go to Settings > System Settings > Controller Configuration and set the Controller Hostname/IP to a hostname or IP address accessible by your devices. Additionally the checkbox "Override inform host with controller hostname/IP" has to be checked, so that devices can connect to the controller during adoption (devices use the inform-endpoint during adoption).
In order to manually adopt a device take these steps:
ssh ubnt@$AP-IP set-inform http://$address:8080/inform
The default device password is
$address is the IP address of the host you are running this container on and
$AP-IP is the Access Point IP address.
When using a Security Gateway (router) it could be that network connected devices are unable to obtain an ip address. This can be fixed by setting "DHCP Gateway IP", under Settings > Networks > network_name, to a correct (and accessible) ip address.
📢 The default setup only publish the 8080 tcp port, which is the bare minimum to allow communication between your network equipment and Unifi Controller. Depending on your requirements, you may need additional ports according to the Documentation .
The recommended way to customize these parameters is to use the inventory :
You should edit
/srv/git/saltbox/inventories/host_vars/localhost.yml and add the following section:
### Open Specified Ports for the specified container ### ##### Unifi Ports for aditional services ##### unifi_docker_ports_custom: - "1900:1900/udp" #Required for Make controller discoverable on L2 network option - "8843:8843/tcp" #Unifi guest portal HTTPS redirect port - "8880:8880/tcp" #Unifi guest portal HTTP redirect port - "6789:6789/tcp" #For mobile throughput test - "5514:5514/udp" #Remote syslog port