Unifi Network Application auf Debian 13 installieren

Diese Anleitung beschreibt die Installation der Unifi Network Application (Version 10+) auf Debian 13 oder Ubuntu 23.10, 24.04, 24.10, 25.04.

Voraussetzungen

  • Debian 13 oder Ubuntu 23.10+
  • Root-Zugriff (oder sudo)
  • Mindestens 2 GB RAM empfohlen

Schritt 1: System aktualisieren

Aktualisiere zuerst die Paketlisten und entferne unnötige Pakete:

sudo apt update && sudo apt upgrade -y && sudo apt autoremove -y

Schritt 2: Erforderliche Pakete installieren

Installiere die benötigten Pakete für Repository-Verwaltung:

sudo apt install -y gnupg curl ca-certificates

Schritt 3: Schlüsselring-Verzeichnis erstellen

Erstelle das Verzeichnis für die Repository-Schlüssel:

sudo install -d -m 0755 /etc/apt/keyrings

Schritt 4: MongoDB Repository hinzufügen

Füge den MongoDB GPG-Schlüssel hinzu:

curl -fsSL https://www.mongodb.org/static/pgp/server-8.0.asc | sudo gpg --dearmor -o /etc/apt/keyrings/mongodb-server-8.0.gpg && sudo chmod 0644 /etc/apt/keyrings/mongodb-server-8.0.gpg

Erstelle die Repository-Datei für MongoDB:

printf 'Types: deb
URIs: https://repo.mongodb.org/apt/debian
Suites: bookworm/mongodb-org/8.0
Components: main
Architectures: amd64
Signed-By: /etc/apt/keyrings/mongodb-server-8.0.gpg
Enabled: true
' | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.sources > /dev/null

Schritt 5: Unifi Repository hinzufügen

Füge den Unifi GPG-Schlüssel hinzu:

curl -fsSL https://dl.ui.com/unifi/unifi-repo.gpg | sudo tee /etc/apt/keyrings/unifi-repo.gpg > /dev/null && sudo chmod 0644 /etc/apt/keyrings/unifi-repo.gpg

Erstelle die Repository-Datei für Unifi:

printf 'Types: deb
URIs: https://www.ui.com/downloads/unifi/debian
Suites: stable
Components: ubiquiti
Architectures: amd64
Signed-By: /etc/apt/keyrings/unifi-repo.gpg
Enabled: true
' | sudo tee /etc/apt/sources.list.d/unifi.sources > /dev/null

Schritt 6: Paketlisten aktualisieren

Aktualisiere die Paketlisten:

sudo apt update

Schritt 7: MongoDB und Unifi installieren

Installiere zuerst MongoDB:

sudo apt install -y mongodb-org

Installiere anschließend die Unifi Network Application:

sudo apt install -y unifi

Schritt 8: Installation überprüfen

Überprüfe, ob die Unifi-Dienste laufen:

sudo systemctl status unifi

✅ Die Installation war erfolgreich, wenn der Dienst als „active (running)“ angezeigt wird!

Zugriff auf das Webinterface

Öffne nach der Installation deinen Browser und rufe auf:

https://[Server-IP]:8443

Folge dem Setup-Assistenten für die Erstkonfiguration.

Hinweise zur Fehlerbehebung

MongoDB startet nicht

Falls MongoDB nicht startet, überprüfe die Logs:

sudo journalctl -u mongod -n 50

Firewall-Einstellungen

Stelle sicher, dass folgende Ports freigegeben sind:

  • TCP 8080 (Geräte-Kommunikation)
  • TCP 8443 (Webinterface / HTTPS)
  • UDP 3478 (STUN)
  • UDP 10001 (Geräte-Erkennung)

Fazit

Mit dieser Anleitung hast du die Unifi Network Application erfolgreich auf einem aktuellen Debian- oder Ubuntu-System installiert. Die neuen Repository-Format-Dateien (.sources) sind zukunftssicher und entsprechen den aktuellen Debian-Standards.

Viel Erfolg mit deinem Unifi Controller!

Kommentar abschicken