Ubiquiti Unifi 5 on Ubuntu or Debian

Ubiquiti Unifi runs fine on hardware as modest as a Raspberry Pi 2, on Debian or Ubuntu. Here we assume the Unifi server is at 192.168.1.2.

Prereqs

Backup existing Unifi configuration:

  1. Navigate to https://unifi.localdomain:8443
  2. Settings > Maintenance > Backup and save to your laptop.
  3. install prereqs
    apt install oracle-java8-jdk
    update-alternatives --config java
    java -version
    

Unifi setup

  1. add to /etc/apt/sources.list.d/ubnt.list
    deb http://www.ubnt.com/downloads/unifi/debian stable ubiquiti
    
  2. execute
    apt-key adv --keyserver keyserver.ubuntu.com --recv 06E85760C0A52C50
    apt update
    apt install unifi
    
  3. after about 10 seconds browse https://192.168.1.2: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.
  4. 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
  5. Unifi updates often include AP firmware updates. Upon AP update, Wifi may go down for a few minutes while the APs say “provisioning”.

Features of Unifi 5

Insights > “Neighboring Access Points”

“Neighboring access points” shows you any other AP (including hidden SSID listed by BSSID). It’s fascinating to see how much better (more sensitive, longer range) the AP is than typical mobile devices. You may see distant SSIDs that you’ve never seen from a mobile or laptop in the same office.

Unifi 5 changelog

As of July 10, 2017 “stable” maps to Unifi 5.5.

Notes

  • Unifi port usage table
  • https://loganmarchione.com/2016/11/ubiquiti-unifi-controller-setup-raspberry-pi-3/
  • 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

Leave a Comment