Inhaltsverzeichnis

Installing UniFi Network Application on Debian 12 (Bookworm)


Finally:

UniFi Network Application 9.1.116 has been released!
UniFi Network Application 7.5 and newer requires MongoDB 3.6 and Java 17.
Version 7.5 to 8.0 supports up to MongoDB 4.4.
Version 8.1 and newer supports up to MongoDB 7.0.
Version 9.0 and newer supports up to MongoDB 8.0 and Java 17/21

Updated 04/15/2025


Installing UniFi Network Appliance on a Linux host can be a challange.
There is a nice Unifi community post1) [ Credits to:Glenn R ] for an automated installation.
It might be paranoid, but I personally prefer to do my own stuff and not let scrips written by others run on my machines (although this one can be checked, as it is open to look into).
For this reason I worked out myself how the challenge is taken within a few moments. It's just a matter of picking the right stuff.

Here you go:
Click on the code to copy to clipboard

Preinstall:

sudo apt install -y apt-transport-https ca-certificates gnupg2 curl

MongoDB Server

You may install MongoDB 8.x or lower (check references for that) depending on your needs or desire.

curl -fsSL https://www.mongodb.org/static/pgp/server-8.0.asc | \
   sudo gpg -o /usr/share/keyrings/mongodb-server-8.0.gpg \
   --dearmor


echo "deb [ signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] http://repo.mongodb.org/apt/debian bookworm/mongodb-org/8.0 main" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list


 sudo apt update; sudo apt install -y mongodb-org 


Be aware, MongoDB 8 requires modern CPUs that support AVX, AVX2. If you are using ProxmoxVE, you will have to adjust the CPU model for your VM
Custom CPU ProxmoxVE

Java Runtime 17 (max. version possible with Debian Repos)

We need Java runtime environment 17 (headless is fine):

sudo apt install -y openjdk-17-jre-headless

Note: don't forget to „apt-mark hold openjdk-17-jre-headless“ , else it will be upgraded on next update run

Add UniFi repo and install

Fetch unifi gpg key, add repo and install:

sudo wget -O /etc/apt/trusted.gpg.d/unifi-repo.gpg https://dl.ui.com/unifi/unifi-repo.gpg;
echo 'deb https://www.ui.com/downloads/unifi/debian stable ubiquiti' | sudo tee /etc/apt/sources.list.d/100-ubnt-unifi.list;
sudo apt update; sudo apt install -y unifi

You may now access your UNA with https://IP.of.your.server:8443 and deploy your backup or create a new site.

Don't forget to consider upscaling, depending on amount of devices at your sites.

Recommendation:
If you want to deploy a backup (*.unf) file, do it before proceeding with next steps.

You may also continue with UNA behind a NGINX reverse proxy if you want to enhance your installation.

References:
https://help.ui.com/hc/en-us/articles/220066768-UniFi-Network-Updating-Third-Party-non-Console-UniFi-Network-Applications-Linux-Advanced-
https://www.mongodb.com/download-center/community/releases
https://www.mongodb.com/docs/manual/tutorial/install-mongodb-on-debian/

Enjoy!

1)
Use this method if you are not really firm with Linux