UniFi Network Application – lokal vs. Cloud Key
Ubiquiti bietet für die UniFi-Verwaltung zwei Wege:
- UniFi Cloud Key (G2, G2+): Hardware-Controller (~100–200 €) – Plug & Play
- Self-hosted (Network Application): Kostenlos, auf eigener Hardware, mehr Kontrolle
Für KMU und Homelab-Nutzer ist die selbst gehostete Variante oft die bessere Wahl: keine laufenden Kosten, kein zusätzliches Gerät, Integration in bestehende Server-Infrastruktur.
Methode 1: Installation auf Ubuntu/Debian
Voraussetzungen
- Ubuntu 22.04 LTS oder Debian 12
- 1 GB RAM Minimum (2 GB empfohlen)
- 10 GB Speicher
- Java 17 (wird automatisch installiert)
Schritt 1: Ubiquiti-Repository hinzufügen
wget -qO - https://dl.ui.com/unifi/unifi-repo.gpg | tee /etc/apt/trusted.gpg.d/unifi.gpg echo "deb https://www.ui.com/downloads/unifi/debian stable ubiquiti" | tee /etc/apt/sources.list.d/unifi.list
Schritt 2: UniFi Network Application installieren
apt update && apt install -y unifi
Installation dauert 2–5 Minuten (lädt Java-Dependencies herunter).
Schritt 3: Dienst starten und Autostart
systemctl enable --now unifi
Status prüfen:systemctl status unifi
Schritt 4: Weboberfläche aufrufen
https://server-ip:8443
Beim ersten Aufruf: Setup-Wizard startet.
- Ubiquiti-Account erstellen oder einloggen
- Local Console wählen für rein lokale Verwaltung (keine Cloud-Verbindung)
- Standort und Zeitzone wählen
- Admin-Zugangsdaten festlegen
Methode 2: Installation als Proxmox LXC-Container (empfohlen)
Die eleganteste Methode: UniFi läuft isoliert als LXC-Container in Proxmox.
Community Script (tteck) – Ein-Befehl-Installation
Das beliebte community-scripts-Projekt von tteck bietet einen One-Click-Installer:
Auf dem Proxmox-Host Shell ausführen:
bash -c "$(wget -qLO - https://github.com/community-scripts/ProxmoxVE/raw/main/ct/unifi.sh)"
Das Script:
- Erstellt automatisch einen Debian-LXC-Container
- Installiert UniFi Network Application
- Konfiguriert den Autostart
Empfohlene Container-Ressourcen (beim Script-Dialog):
- RAM: 2048 MB
- Disk: 10 GB
- Netzwerk: vmbr0
Manuell als LXC-Container
Proxmox-Weboberfläche → Container erstellen:
- Template: Debian 12
- RAM: 2048 MB
- Disk: 10 GB
- IP: z. B. 192.168.1.20/24
Im Container: Identische Installationsschritte wie Ubuntu oben.
UniFi Access Points adoptieren
Adopt mit der Network Application
- AP an Switch anschließen und mit DHCP-Netz verbinden
- In der UniFi-Weboberfläche: Devices → AP erscheint mit Status "Pending Adoption"
- Klicken Sie Adopt → AP verbindet sich mit dem Controller
Adopt per SSH (falls AP bereits mit anderem Controller verbunden)
ssh ubnt@ap-ip-adresse (Passwort: ubnt bei Werkseinstellung)
set-inform http://controller-ip:8080/inform
WLAN-Netzwerk erstellen
Settings → WiFi → Add New WiFi Network:
- SSID: Name des WLAN-Netzes (z. B. "Firma-WiFi")
- Security Protocol: WPA3/WPA2 (empfohlen: WPA3)
- Password: Starkes WLAN-Passwort
- Network: VLAN auswählen (falls VLAN-Segmentierung genutzt)
- Band Steering: An (verteilt Clients optimal auf 2,4/5/6 GHz)
Gastнetz einrichten
Settings → WiFi → Add New → Gast-Netzwerk:
- Eigene SSID (z. B. "Besucher")
- Anderes VLAN (isoliert von Firmennetz)
- Portal: optional Splash Page mit Nutzungsbedingungen
Controller aktuell halten
UniFi veröffentlicht regelmäßig Updates. Manuelles Update:
apt update && apt upgrade -y unifi
Vor Updates: Backup erstellen unter Settings → System → Backup.
UniFi-Controller Backup
Automatisch: Settings → System → Backup → tägliches Backup aktivieren
Manuell herunterladen: Settings → System → Backup → Download
Backup-Datei sicher aufbewahren – sie enthält alle Konfigurationen, Adopt-Zertifikate und Statistiken.
Häufige Probleme
AP erscheint nicht in "Pending Adoption":
AP muss denselben Layer-2-Broadcast-Domain wie der Controller erreichen können. Bei VLAN-Trennung: DHCP-Option 43 mit Controller-IP setzen.
"Controller is not reachable" nach Update:
Java-Version prüfen: java -version – muss Java 17 oder 21 sein.
UniFi-Log: journalctl -u unifi -n 100
AP verliert Verbindung zum Controller:
Inform-URL auf AP überprüfen: Im AP-Terminal: mca-dump | grep inform
FAQ
Muss der UniFi-Controller immer laufen?
Nur für Konfigurationsänderungen, Statistiken und Adoptions. Die APs funktionieren auch wenn der Controller offline ist – sie verlieren nur die Verbindung zur Verwaltung.
Kann ich mehrere Standorte in einer Instanz verwalten?
Ja, über Sites in der Network Application. Verschiedene Standorte bleiben konfiguratorisch getrennt, sind aber über eine URL erreichbar.
Was kostet die UniFi Network Application?
Vollständig kostenlos. Ubiquiti verdient an der Hardware (APs, Switches, Gateways).
Fazit
Der selbst gehostete UniFi-Controller auf Linux oder Proxmox ist die kosteneffizienteste Lösung für professionelles WLAN-Management. Für KMU mit mehreren Access Points eine klare Empfehlung.
Als Ubiquiti-Partner in Heidelberg planen und installieren wir UniFi-Infrastrukturen für Unternehmen in Mannheim, Ludwigshafen und der Rhein-Neckar-Region. Jetzt WLAN-Beratung anfragen.