UniFi Network Application (Docker)

UniFi Network Application (Controller) mit MongoDB, alle persistenten Daten liegen im Projektordner unter ./data/.

• Image: linuxserver/unifi-network-application
• Datenbank: MongoDB 4.4 (bewusst — die CPU dieses Rechners hat kein AVX, MongoDB 5+ würde nicht starten. Nicht auf ein neueres Mongo-Image wechseln!)

Erster Start

docker-compose up -d
docker-compose logs -f unifi-network-application   # warten bis der Start durch ist

Danach im Browser: https://:8443 (selbstsigniertes Zertifikat, Warnung einmalig bestätigen). Im Einrichtungs-Assistenten kann auch direkt ein vorhandenes Backup (.unf) eingespielt werden.

Wichtig: Inform-Port ist 8082 (nicht 8080!)

Port 8080 ist auf diesem Host bereits belegt, deshalb lauscht der Inform-Port für die Geräte-Adoption auf 8082. Damit Geräte sich melden:

• In der Weboberfläche: Einstellungen → System → Erweitert → "Inform Host" überschreiben aktivieren und <host-ip>:8082 eintragen, oder
• pro Gerät per SSH: set-inform http://<host-ip>:8082/inform

Ports

Host-Port	Zweck
8443	Weboberfläche (HTTPS)
8082	Inform / Geräte-Adoption (→ 8080 intern)
3478/udp	STUN
10001/udp	Geräte-Discovery
8843	Gäste-Portal HTTPS (optional)
8880	Gäste-Portal HTTP (optional)
6789	Mobile Speedtest (optional)

Aktualisieren

./update.sh

Erstellt zuerst ein Backup, zieht dann die neuesten Images und startet die Container neu. Alle Daten bleiben in ./data/ erhalten.

Backups

./backup.sh          # kopiert die UniFi-Autobackups (.unf) nach ./backups/
./backup.sh --full   # Komplett-Backup von ./data als tar.gz (kurze Downtime)

Autobackups einmalig in der Weboberfläche aktivieren: Einstellungen → System → Backups → Automatische Sicherung.

Wiederherstellen

./restore.sh backups/unifi-full-backup_<datum>.tar.gz   # Komplett-Restore
./restore.sh backups/autobackup_<datum>/<datei>.unf     # .unf bereitstellen

.unf-Backups werden anschließend in der Weboberfläche eingespielt (Einstellungen → System → Backups → Wiederherstellen) oder bei einer Neuinstallation direkt im Einrichtungs-Assistenten.

Verzeichnisstruktur

data/mongodb/   MongoDB-Datenbank
data/unifi/     UniFi-Konfiguration, Logs, Autobackups
backups/        von backup.sh erstellte Sicherungen
.env            Zugangsdaten der Datenbank (nicht weitergeben)