Zum Inhalt springen
Engineering/Notes

UniFi Controller Raspberry Pi Installation

Markus Schemp
Markus Schemp
14. April 2020 · 3 Min. Lesezeit
InfrastrukturNetzwerk

Hier geht es um die Installation des UniFi Controllers auf dem Raspberry Pi (3). Nachdem ich dabei selbst ein paar Mal vor Herausforderungen stand, hier die Anleitung, die für mich bisher am besten geklappt hat und am einfachsten war.

Vorbereitung des Raspberry Pi

Um überhaupt anfangen zu können, braucht dein Raspberry Pi ein möglichst aktuelles Raspbian, und SSH sollte aktiviert sein. Ich gehe dazu immer wie folgt vor:

  1. Hole dir den Raspbian Imager von https://www.raspberrypi.org/downloads/ und flashe mit ihm ein Raspbian Lite (das reicht) auf deine microSD-Karte
  2. Schließe Tastatur und Monitor an den Raspberry Pi an und boote einmal
  3. Anmelden kannst du dich mit dem User pi und dem Passwort raspberry
  4. Mit dem Befehl sudo raspi-config kannst du nun die ersten wichtigen Einstellungen vornehmen
    1. Über Localization -> Change Keyboard Layout kannst du das deutsche Tastaturlayout einstellen
    2. Du kannst das Standard-Passwort ändern (empfohlen, aber merke es dir gut!)
    3. Über Network -> Hostname kannst du den Hostname ändern, z. B. in UniFiController, um später gut darauf zugreifen zu können
    4. Über Interfacing Options -> SSH kannst du SSH aktivieren
  5. Danach musst du deinen Raspberry neu starten und kannst dich (sofern er über ein Netzwerkkabel verbunden ist) über SSH anmelden
    • Unter Mac/Linux kannst du dazu einfach in der Konsole ssh pi@unificontroller (oder deinen gewählten Hostnamen) eingeben
    • Unter Windows kann ich Putty sehr empfehlen https://www.putty.org/
  6. Jetzt solltest du mit sudo apt-get update und sudo apt-get upgrade noch die Basis-Software des Raspberry auf den aktuellen Stand bringen

Installation des UniFi Controllers

Bevor es an die eigentliche Installation des UniFi Controllers geht, müssen wir noch ein paar Abhängigkeiten vorab prüfen, installieren und konfigurieren.

Abhängigkeiten installieren

Für mich fast das Wichtigste an diesem Artikel – hier musst du die richtige Java-Version installieren. Der UniFi Controller benötigt Java Version 8 – die wird im Standard aber nicht mehr ausgeliefert.

  1. Zunächst prüfen wir, ob der Directory-Manager schon installiert ist und installieren ihn, falls noch nicht geschehen: sudo apt-get install dirmngr -y
  2. Da Java 8 von Oracle nicht mehr ausgeliefert wird, installieren wir nun OpenJDK 8:
bash
sudo apt install openjdk-8-jdk
  1. Dann fügen wir mit zwei Befehlen die ubnt Paketquellen hinzu:
bash
echo 'deb http://www.ubnt.com/downloads/unifi/debian stable ubiquiti' | sudo tee /etc/apt/sources.list.d/100-ubnt-unifi.list
sudo wget -O /etc/apt/trusted.gpg.d/unifi-repo.gpg https://dl.ubnt.com/unifi/unifi-repo.gpg

UniFi Controller installieren

Und jetzt kommt der einfachste Teil, wir installieren den UniFi Controller: sudo apt-get update; sudo apt-get install unifi -y

Das war’s schon. Sobald die Installation durchgelaufen ist, kannst du über deinen Browser über https://unificontroller:8443 (oder deinen Hostnamen) auf den UniFi Controller zugreifen und ihn konfigurieren.

Ich hoffe, ich konnte dir mit dieser Anleitung ein bisschen weiterhelfen.

Markus Schemp
Markus Schemp
Softwareentwickler mit mehr als 15 Jahren Erfahrung in Softwareentwicklung und Engineering und mehr als 10 Jahren technischer Führung. Schwerpunkte: Softwarearchitektur, Modernisierung, DevOps und KI-gestützte Softwareentwicklung.
Profil ansehen
Woran ich sonst arbeiteLeistungen im ÜberblickEngineering Notes entstehen im eigenen Betrieb. Beruflich berate ich Unternehmen, deren Geschäft Software ist oder wird.

Inhalt