Hansesystems Fortech GmbH & Co. KG Logo

UniFi Controller installieren unter Ubuntu 20.04

Der UniFi Controller findet Verwendung sobald mehrere aktive Netzwerkgeräte oder sogar Sites administriert werden sollen. Mit ihm ist die Einsicht in Geräte-Statistiken möglich. Grund genug, dass wir uns ansehen wie dieser installiert wird. In diesem Beitrag beschreiben wir die Installation auf einem Ubuntu LTS 20.04 Linux System.

 

Anforderungen UniFi Controller Installation

Wir gehen davon aus, dass die Installation eines lauffähigen Ubuntu 20.04 Systems stattgefunden hat und alle relevanten Einstellungen wie zum Beispiel UFW, Systemzeit, Hostname, IP vorgenommen wurden. Für den Vorgang der Installation des UniFi Controller müssen wir bei Installation aus den Sourcequellen, externe hinzufügen. Gleichzeitig benötigen wir für diesen Vorgang sudo oder root Rechte und müssen in bestimmten Systemdateien Änderungen vornehmen.

Hinweis: Wir verwenden das APT Tool, da hierdurch Updates leichter eingespielt werden können.

 

Anpassungen von APT

Um die Anpassung vorzunehmen ist es notwendig am System angemeldet zu sein. Hierfür eignet sich hervorragend das Tool Putty. Entscheidet bitte selbst ob die Anmeldung mit einem Useraccount oder root geschieht. Wir verwenden einen Useraccount und stellen vor die Kommandos daher das sudo.

 

Paketquellen aktualisieren

sudo apt-get update

Apt Transport via HTTPS

sudo apt-get install ca-certificates apt-transport-https

Externe Sourcelist anlegen

echo 'deb https://www.ui.com/downloads/unifi/debian stable ubiquiti' | sudo tee /etc/apt/sources.list.d/100-ubnt-unifi.list

GPG Schlüssel hinzufügen

sudo wget -O /etc/apt/trusted.gpg.d/unifi-repo.gpg https://dl.ui.com/unifi/unifi-repo.gpg

Dadurch wird der entsprechende Schlüssel in /etc/apt/trusted.gpg.d installiert.

 

Installation UniFi Controller

Kommen wir nun zum eigentlichen Punkt, der Installation. Unter Verwendung der folgenden Kommandos, wird der Controller installiert und ist im Anschluss bereit für die Einrichtung.

Wichtig: Der UniFi Controller ist eine Java Anwendung und benötigt unbedingt das openjdk-8-jre-headless Paket.

Wir beginnen damit, diese Abhängigkeit aufzulösen indem wir die entsprechende Java Version installieren.

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

Der Vorgang kann einen Augenblick in Anspruch nehmen. Mit dem hinten angestellten -y bestätigen wir Anfragen während der Installation mit Ja/Yes.

Kommen wir nun zu der eigentlichen Installation des Controller.

sudo apt-get update && sudo apt-get install unifi -y

Im Anschluss an diese Installation prüfen wir noch den Status von unifi

sudo service unifi status

Steht der Service in grün auf running, ist der Zugriff auf die weitere webbasierte Konfiguration möglich und der Controller kann eingerichtet werden.

https://IP des Server:8443

 

Hilfreiche Kommandos und Logs

Hilfreiche Kommandos wären folgende:

Status des UniFi Dienst abfragen

sudo service unifi status

UniFi stoppen

sudo service unifi stop

UniFi Service starten

sudo service unifi start

 

Wichtige Log- Dateien liegen unter:

  • /usr/lib/unifi/logs/server.log
  • /usr/lib/unifi/logs/mongod.log

Unter Verwendung von tail ist es euch möglich, die Logs in Echtzeit auszulesen.

sudo tail -f /usr/lib/unifi/logs/server.log

 

Schlusswort

Wir hoffen eure Installation des UniFi Controller hat geklappt und ihr seid nun in der Lage, eure Geräte darüber zu managen. Schaut gerne in einen unser anderen Artikel, in dem wir das Thema UniFi Cloud Controllerhinter nginx Reverse Proxy betreiben beschreiben. Der Vorteil ist nicht nur, dass der Controller in eurer Struktur sicherer betrieben werden kann, sondern auch die Nutzung von Let´s Encrypt Zertifikaten zur TLS Verschlüsselung.

power-switchmenuchevron-down