Unifi Controller onder Debian 10

Om Ubiquiti Unifi netwerkapparatuur te kunnen beheren kunt u een UniFi Dream Machine of een Cloud key kopen of de controllersoftware zelf hosten op uw computer, een NAS of een thuisserver. Ook circuleren er allerlei docker-images op het internet, het nadeel hiervan is dat de onderhoud hiervan in handen ligt van derde partijén waardoor nieuwe wijzigingen soms op zich kunnen laten wachten.

Deze handleiding is gebaseerd op de handleiding die Ubiquiti zelf aanbied waarbij de controller via APT kan worden geïnstalleerd. Ubiquiti zelf ondersteund ten tijden van schrijven van dit artikel hooguit Debian 9. Wij gaan in dit geval al uit van Debian 10 !

Installeer eerst wat hulppakketten en haveged die ervoor zorgen dat de Linux pseudo random number generator voldoende entropie heeft..


Nu kunnen we de softwarepakketten installeren. Naast de UniFi Network Controller zelf, moeten we een compatibele versie van MongoDB en de JVM installeren. De UniFi Network Controller versie 7.1 (de laatste vanaf juli 2022) ondersteunt de huidige MongoDB 4.x en Java 11 niet. Je hebt MongoDB 3.x en Java 8 nodig om de controllersoftware te laten werken. De volgende stappen leiden u door de installatie van MongoDB 3.6 en de AdoptOpenJDK 8 HotSpot VM vanuit de officiële repositories.

Download eerst de vertrouwde sleutel voor de UniFi-, AdoptOpenJDK- en MongoDB 3.6-repositories en voeg ze toe aan de Debian-bronlijsten. Voor MongoDB 3.6 gebruiken we de Debian Stretch-repo omdat er geen Debian Buster-repo is voor MongoDB 3.x.


Nu kunnen we de pakketlijst bijwerken, de bestaande OpenJDK 11-installatie verwijderen (die vooraf is geïnstalleerd met Debian Buster) en de nieuwe pakketten installeren.


Zorg er ten slotte voor dat de UniFi Network Controller, MongoDB en haveged automatisch worden gestart bij het opstarten.


Je bent helemaal klaar! Ga naar https://<JE_THUISSERVER_IP>:8443/ om toegang te krijgen tot de gebruikersinterface van de UniFi Network Controller. Als de gebruikersinterface niet toegankelijk is, controleer dan met sudo systemctl status unifi.service of de UniFi-service succesvol is gestart of dat er foutmeldingen zijn. Het kan trouwens enige tijd duren voordat de Unifi Controller is opgestart, dit is afhankelijk van de snelheid van het door u gebruikte apparaat waarop u alles geïnstalleerd heeft. Dit komt o.a. door Java, MongoDB maar ook Unifi. Geef het dus even de tijd!


Omdat de software voor de Ubiquiti Unifi-reeks soms te wensen over laat, heb ik besloten om de Unifi Controller software de hold-markering te geven. Hierdoor zal bij een update niet direct de meest recente versie worden geïnstalleerd en heb ik zelf de keuze dit handmatig te doen. Dit markeren doe je met commando;

Wanneer nu een nieuwe versie uitkomt zal deze wel worden getoond, maar zal het updaten ervan worden uitgesteld tot je deze zelf handmatig wilt installeren.

TIP Op Ubiquiti Downloads kan je de release notes en een verwijzing naar de forum-posts vinden. Zelf installeer ik een update pas wanneer het aantal klachten en problemen "minimaal" is.