Ubiquiti Unifi on Ubuntu or Debian

Ubiquiti Unifi runs fine on hardware as modest as a Raspberry Pi 2, on Debian or Ubuntu.

Unifi setup

  1. run the commands

     echo "deb http://www.ubnt.com/downloads/unifi/debian stable ubiquiti" > /etc/apt/sources.list.d/ubnt.list
     apt-key adv --keyserver keyserver.ubuntu.com --recv 06E85760C0A52C50
     apt update
     apt install unifi
  2. after about 10 seconds browse https://localhost:8443 – note the https is required. If you have a very slow CPU (slower than Raspberry Pi 2) you may need to wait a little longer.

Unifi Prereqs

Java 8 is recommended for Unifi >= 5.3, and at least Java 7 is required. Oracle Java is said to be lighter-weight than OpenJDK

apt install oracle-java8-jdk
update-alternatives --config java
java -version


Unifi firewall ports

Unifi port usage table

For basic functionality you need ports open to the network your APs are on (not worldwide!):

  • 8080 UAP -> Unifi server
  • 8443 HTTPS admin control panel



Leave a Comment