Installing Ubiquiti UniFi Controller on Linux Debian 10

Prerequisites

If you’re installing on Linux, be sure you have the following ahead of time:

  • A current Debian or Ubuntu OS with root access – The steps will use Debian 10
  • An account for unifi.ui.com

And that’s it. Everything else will be handled during the install process.

Installing the Controller

To get the controller installed on Linux you have many options. Ubiquiti has some instructions on how to install the controller on their website but it only covers the install for a couple of specific versions of Linux. To use Debian, use the script that has been posted on the Unifi forums by member AmazedMender16.

To start the install, first ssh into the Debian server or access the server from the console. Log in either as root or as another user that has root access and then run su.

Update the apt repos.

apt-get update

Next, install the ca-certificates and wget packages.

apt-get update && apt-get install ca-certificates wget -y

Download and run the Unifi Controller installer script. This script will handle the install of the dependencies and controller software for many different distros of Linux including the Debian 10 server we are using.

wget https://get.glennr.nl/unifi/install/install_latest/unifi-latest.sh1 bash unifi-latest.sh

You will be prompted for a few things while the script runs. First, it will ask if you want to keep the script downloaded after the install. In most cases this is not required, so you should enter n and then press enter.

Ensuring the Unifi controller software is kept up to date

You may receive a prompt to update packages during the install. Enter y and then press enter.

Confirming it’s OK to update packages

Finally, you will be prompted to add the apt repo for Unifi to update the controller from apt. Enter y and press enter as this will make upgrades serviceable through apt.

Adding the Unifi Network Controller repo to apt

Once the install completes, the script will output the version of the controller installed and the URL to use to start configuring the controller.

Configuring the Controller

Once you have the controller software installed on whatever server you are using the setting will be the same.

Go to the web address https://<ServerIP&gt;:8443/ and you will be presented with the controller’s web portal.

Author: griffethbarker

Griff is a tinkerer and manager of IT, consultant of IT and management, and continuous student of organizational development. His hobbies and interests include games of all types (video, board, dice, card, tabletop, etc.) as well as listening to music, photography, and writing. Find him on LinkedIn!

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out /  Change )

Google photo

You are commenting using your Google account. Log Out /  Change )

Twitter picture

You are commenting using your Twitter account. Log Out /  Change )

Facebook photo

You are commenting using your Facebook account. Log Out /  Change )

Connecting to %s