An ansible playbook for installing the Unifi Network Controller.
| OS | Notes |
|---|---|
| Debian 11 (bullseye) | Recommended |
| Ubuntu 22.04 LTS (jammy) | Uses old libssl deb package for mongodb, uses focal for AdoptJDK repo |
| Ubuntu 20.04 LTS (focal) | Uses old libssl deb package for mongodb |
- Ansible is installed in your PC (instructions are here).
- One of the supported operating systems above is reachable by ssh.
To run the playbook you will need the IP or hostname of the target server you want to install the Unifi controller on.
- Open a terminal and run the following. The below command assumes you
TARGETPC= # put your IP address, hostname or fqdn here. Can be comma separated for multiple servers
ansible-playbook unifi_network_controller_setup.yml -i $TARGETPC,Append the following based on your how you connect to your server
--user myusername # To connect with a specific user account
--ask-pass # If an SSH password is required.
--become # for sudo escalation
--ask-become-pass # If you need to enter a password for sudo escalation.example below:
TARGETPC=192.168.2.4
ansible-playbook unifi_network_controller_setup.yml -i $TARGETPC, --ask-pass --become --ask-become-pass --user larry- After installing you should be able to access the controller by using the following url:
https://{controller IP or fqdn}:8443
e.g. https://192.168.4.2:8443
- Then accept the warning about the invalid certificate to go through the initial setup wizard.
- MongoDB 3.x is the only release that is currently supported by the Unifi Network Controller. However 3.6 was retired in April 2021 and is now end of life. Unfortunately until Ubiquiti improves their mongodb support, 3.6 must be installed.
- If you would like to use a valid TLS certificate I would suggest to look into acme.sh with LetsEncrypt as it has built in support for deploy hooks with the Unifi Network Controller. There is also an ansible community module for importing certificates into the Java Keystore over here.
- A the time of writing, AdoptJDK did not have a repository release for 22.04 (jammy) and focal was used in its place.
- AdoptJDK is no longer supported and has moved over to Eclipse Temurin. I haven't tested moving to this variant yet and I was personally hoping for a repository to help keep it up to date. I will also consider AWS Correto 8 as well, they also have their own debian packages.
Are you interested to know more about the Unifi network controller? Want to know how layer 3 adoption works? Check out my postings for Unifi over at https://karubits.com/tags/unifi/ ❤️