Logbuch#netzwerk#docker#monitoring
UniFi OS Server läuft nicht in Docker — und Ubiquiti sagt das selbst
Von Niclas Hennrich
Entdeckt und recherchiert, noch nicht selbst betrieben.
Warum überhaupt UniFi: Ich baue mir ein eigenes kleines Dashboard fürs Homelab und suchte eine Referenz für die nächsten Ausbaustufen — Topologie, Geräte-Details, Port-Darstellung, Ereignisse. UniFi Network ist dafür der naheliegende Maßstab. Gesucht war ausdrücklich keine produktive UniFi-Infrastruktur, sondern eine isolierte Testumgebung, die ich rückstandsfrei wieder loswerde.
Der Plan war: UniFi OS Server in Docker. Der Plan ging nicht auf.
Ubiquiti sagt es selbst. Im Help-Center-Artikel Self-Hosting UniFi (Stand 23.08.2026) steht in der FAQ:
„Will this be available as a standalone Docker/Podman container? No. This is a complete solution that requires certain services to be run on the host to enable device discovery, adoption, and automatic system updates."
Das ist kein „noch nicht", sondern eine Architekturaussage: Geräteerkennung und Adoption brauchen Dienste direkt auf dem Host.
Was die kursierenden Images dann sind: Es gibt sehr wohl Docker-Images für UniFi OS Server. Sie sind aus dem proprietären Installer extrahiert — weder unterstützt noch verlässlich updatefähig. Für einen Host, auf dem mein halbes Homelab läuft, ist das keine Option. Für eine Wegwerf-VM mag man anders entscheiden; ich wollte das Risiko auf der Maschine nicht.
Wichtig für die Suche: Zwei Dinge werden ständig verwechselt. UniFi OS Server ist der neue offizielle Self-Hosting-Weg — UniFi-OS-Shell plus Network-App. Der klassische UniFi Network Application-Container ist etwas anderes und läuft weiterhin problemlos in Docker. Wer nur die Netzwerk-Oberfläche als Referenz sehen will, ist damit bedient.
Nebenbefund: Mir ist dabei aufgefallen, dass ich gar keine Konvention für Test-Container hatte — alles lag unter demselben Pfad wie die produktiven Stacks. Für etwas, das ich ausdrücklich wieder wegwerfen will, ist das der falsche Ort. Das ist jetzt getrennt.