Solange Access Point und Controller im selben Netz hängen, ist die Adoption ein Klick: Das Gerät taucht von allein in der Oberfläche auf, du drückst „Adopt“, fertig. Sobald der Controller aber woanders läuft – in einem anderen VLAN, an einem anderen Standort oder als gehosteter Cloud-Controller im Rechenzentrum – findet sich das Gerät nicht mehr von selbst. Dann brauchst du die Layer-3-Adoption. Dieser Ratgeber zeigt dir Schritt für Schritt, welche Wege es dafür gibt, welche Ports offen sein müssen und woran die Adoption typischerweise scheitert.
Layer 2 oder Layer 3 – was trifft auf dich zu?
Adoption ist der Vorgang, bei dem ein UniFi-Gerät – ein Access Point, ein Switch, eine Kamera oder ein Sensor – mit der UniFi-Anwendung verbunden wird, die es künftig verwaltet. Erst danach lässt sich das Gerät konfigurieren, mit Firmware versorgen und überwachen. Ein frisch ausgepackter oder zurückgesetzter Access Point sucht aktiv nach einem Controller und meldet sich dort als Pending Adoption an.
Diese Suche funktioniert im lokalen Netz über Broadcast-Verfahren. Geräte im selben Subnetz erscheinen deshalb in der Regel ohne jedes Zutun im Controller – das ist die Layer-2-Adoption. Liegt eine Routing-Grenze dazwischen, kommt der Broadcast nicht mehr an, und es braucht die Layer-3-Adoption. Ubiquiti selbst beschreibt sie als Verfahren für fortgeschrittene Nutzer beziehungsweise für die Adoption an eine UniFi Cloud Console.
| Situation | Verfahren |
|---|---|
| AP und Controller im selben Subnetz | Layer 2 – Gerät erscheint automatisch |
| AP im Management-VLAN, Controller in einem anderen VLAN | Layer 3 |
| Controller an einem anderen Standort | Layer 3 |
| Gehosteter Cloud-Controller im Rechenzentrum | Layer 3 |
Voraussetzung: Diese Ports müssen erreichbar sein
Bevor du irgendeine Methode ausprobierst, prüfe die Netzwerkfreigaben. Ohne offene Ports läuft keines der folgenden Verfahren. Zwischen dem UniFi-Host und den UniFi-Geräten müssen TCP 8080 und UDP 10001 durch alle Gateways, Firewalls und Antiviren-Programme hindurch offen sein. Für die Layer-3-Adoption ist besonders die uneingeschränkte Erreichbarkeit über TCP-Port 8080 entscheidend – über diesen Port meldet sich das Gerät beim Controller.
| Port | Protokoll | Wofür |
|---|---|---|
| 8080 | TCP | Inform-Port – Kommunikation Gerät → Controller |
| 10001 | UDP | Geräte-Discovery im lokalen Netz |
| 8443 | TCP | Weboberfläche und API des Controllers |
| 3478 | UDP | STUN |
Ein Detail, das immer wieder für Verwirrung sorgt: Die Inform-URL verwendet HTTP, nicht HTTPS. Das Standardformat lautet http://unifi:8080/inform. Wer hier auf gut Glück https einträgt, wartet vergeblich auf das Gerät.
Die Wege zur Layer-3-Adoption
Ubiquiti dokumentiert mehrere Verfahren. Welches passt, hängt davon ab, wie viele Geräte du ausrollst und wie viel Kontrolle du über das lokale Netz hast.
1. Per SSH mit set-inform
Der direkteste Weg für einzelne Geräte. SSH ist auf UniFi-Netzwerkgeräten standardmäßig aktiviert, du kommst also unmittelbar nach einem Werksreset auf das Gerät. Dafür musst du dich im selben lokalen Netz wie der Access Point befinden.
- IP-Adresse des Access Points ermitteln – etwa über die DHCP-Leases deines Routers.
- Per SSH auf das Gerät verbinden. Vor der Adoption gelten die Standard-Zugangsdaten
ui/ui, bei älteren Gerätenubnt/ubnt. - Auf dem Gerät das Kommando absetzen:
set-inform http://<ip-oder-hostname>:8080/inform - Das Gerät erscheint daraufhin im entfernten Controller und lässt sich dort wie bei einer normalen Layer-2-Adoption übernehmen.
Wichtig zu wissen: Nach der Adoption sind die SSH-Zugangsdaten des Geräts nicht mehr ui/ui, sondern eine zufällig erzeugte Zeichenfolge, die der Controller vergibt.
2. DHCP Option 43
Das Verfahren der Wahl, wenn du viele Geräte gleichzeitig ausrollst: Der DHCP-Server teilt dem UniFi-Gerät direkt mit, wo der Controller zu finden ist. Bei den meisten Fremdherstellern wird Option 43 in Hex kodiert, und es gibt zwei Varianten:
- Über die IP-Adresse: Beginne mit
0104und hänge die statische IP in Hex an. Aus 192.168.3.10 wird so0104c0a8030a– ohne Leerzeichen. - Über den FQDN: Beginne mit
02, dann die Länge des FQDN in Bytes (hexadezimal), dann die in Hex umgewandelte Inform-URL.
Für zusätzliche Redundanz lassen sich IP und FQDN in derselben DHCP-Option hinterlegen. Voraussetzung bleibt in jedem Fall die uneingeschränkte Erreichbarkeit über TCP-Port 8080.
3. Über einen DNS-Eintrag
Die eleganteste Variante, wenn du den lokalen DNS kontrollierst. UniFi-Geräte fragen standardmäßig den Hostnamen unifi ab. Zeigt in deinem Netz ein A-Record unifi auf die IP des Controllers – oder ein CNAME auf dessen FQDN –, findet das Gerät den entfernten Controller ohne weitere Eingriffe. Das ist besonders praktisch, weil neue Geräte damit automatisch am richtigen Ziel landen, ohne dass du sie einzeln anfassen musst.
4. Über die UniFi Mobile App
Die App für iOS und Android kann die Adoption abkürzen, wenn dein Netzwerk bereits WLAN im selben VLAN ausstrahlt, in dem das noch nicht adoptierte Gerät hängt. Für einzelne Nachzügler ist das oft der schnellste Weg.
5. Zero-Touch Provisioning (ZTP)
ZTP ist Ubiquitis Antwort auf den Aufwand der manuellen Adoption: Das Gerät wird eingesteckt und adoptiert sich selbst – ohne dass jemand „Adopt“ klicken muss. Damit vereinfacht ZTP die Adoption über VLAN-Grenzen und entfernte Netze hinweg spürbar. Die Unterstützung ist allerdings noch begrenzt: Laut Ubiquiti wird ZTP derzeit von U7-Pro-Max-Access-Points unterstützt, weitere Geräte sollen folgen.
Eine Falle solltest du kennen: ZTP-Codes bleiben gültig, solange das Gerät nicht über die Hardware-Reset-Taste zurückgesetzt wird. Wer den Code erhalten will, setzt das Gerät deshalb immer über die UniFi-Verwaltungsoberfläche zurück – nicht über den Knopf am Gehäuse. Betreibst du ohnehin ein lokales UniFi Cloud Gateway oder eine andere UniFi-Konsole vor Ort, bringt ZTP gegenüber der Standard-Adoption keinen zusätzlichen Nutzen.
Methoden im Vergleich
| Methode | Gut geeignet für | Voraussetzung |
|---|---|---|
| SSH / set-inform | Einzelne Geräte, Fehlersuche | Zugriff im lokalen Netz, SSH-Zugangsdaten |
| DHCP Option 43 | Größere Rollouts | Kontrolle über den DHCP-Server |
| DNS-Eintrag „unifi“ | Dauerhafte Standardlösung | Kontrolle über den lokalen DNS |
| Mobile App | Einzelne Geräte vor Ort | WLAN im selben VLAN wie das Gerät |
| ZTP | Remote-Rollouts ohne Technikereinsatz | Unterstütztes Modell (aktuell U7 Pro Max) |
Nach der Adoption: Inform-Host überschreiben
Ist das Gerät übernommen, sollte es den Controller auch dauerhaft zuverlässig erreichen. Dafür gibt es in der UniFi-Anwendung die Option, den Inform-Host mit einem festen Hostnamen oder einer festen IP zu überschreiben. Ist sie gesetzt, verwendet der Controller genau diese Adresse und überschreibt damit die bestehenden Inform-URLs der Geräte.
Zwei Hinweise dazu: Erstens muss die Namensauflösung für den hinterlegten Hostnamen einwandfrei funktionieren – sonst verlieren die Geräte den Kontakt. Zweitens bringt es nichts, die Konfigurationsdateien direkt auf den Geräten zu bearbeiten: Diese Änderungen werden vom Controller wieder überschrieben. Die Einstellung gehört in den Controller, nicht auf den Access Point.
Wenn es klemmt: typische Stolpersteine
- Das Gerät erscheint gar nicht: Prüfe, ob TCP 8080 und UDP 10001 zwischen Gerät und UniFi-Host tatsächlich offen sind – inklusive lokaler Firewalls und Antiviren-Software.
- „Managed by other“: Das Gerät ist noch bei einem anderen Controller adoptiert. Es muss dort freigegeben oder zurückgesetzt werden.
- Gerät reagiert nicht mehr: Die Reset-Taste zehn Sekunden gedrückt halten. Die LED sollte danach dauerhaft weiß leuchten. Als letztes Mittel bleibt der Werksreset – danach beginnst du mit der Layer-3-Adoption von vorn.
- Falsches Protokoll in der Inform-URL: Es ist
http://, nichthttps://, und der Port ist standardmäßig 8080.
Fazit
Layer-3-Adoption ist kein Hexenwerk, sie verlangt aber Sorgfalt an drei Stellen: offene Ports, die korrekte Inform-URL und ein sauber gesetzter Inform-Host nach der Übernahme. Für einzelne Geräte ist set-inform per SSH der schnellste Weg, für größere Umgebungen lohnen sich DHCP Option 43 oder ein DNS-Eintrag als dauerhafte Lösung. Wenn du dir den Betrieb des Controllers samt Erreichbarkeit, Updates und Backups komplett sparen möchtest, betreiben wir deinen UniFi Cloud Controller in einem deutschen, DSGVO-konformen Rechenzentrum – inklusive einer festen Adresse, auf die deine Access Points dauerhaft informen können.
Häufige Fragen
Was ist der Unterschied zwischen Layer-2- und Layer-3-Adoption?
Bei der Layer-2-Adoption befinden sich Gerät und Controller im selben Subnetz – das Gerät erscheint dort in der Regel automatisch als „Pending Adoption“. Bei der Layer-3-Adoption liegt eine Routing-Grenze dazwischen, etwa ein anderes VLAN, ein anderer Standort oder ein gehosteter Controller. Dann muss dem Gerät aktiv mitgeteilt werden, wo der Controller zu finden ist.
Wie lautet das set-inform-Kommando?
set-inform http://<ip-oder-hostname>:8080/inform – abgesetzt per SSH direkt auf dem UniFi-Gerät. Danach erscheint es im entfernten Controller und kann dort übernommen werden. Beachte: HTTP, nicht HTTPS.
Welche Zugangsdaten gelten für den SSH-Zugriff vor der Adoption?
Vor Einrichtung und Adoption gelten die Standard-Zugangsdaten ui / ui, bei älteren Geräten ubnt / ubnt. SSH ist auf UniFi-Netzwerkgeräten standardmäßig aktiviert. Nach der Adoption vergibt der Controller eine zufällig erzeugte Zeichenfolge als Zugangsdaten.
Welche Ports muss ich für die Adoption freigeben?
Zwischen UniFi-Host und UniFi-Geräten müssen TCP 8080 und UDP 10001 offen sein – durch alle Gateways, Firewalls und Antiviren-Programme hindurch. Für die Layer-3-Adoption ist die uneingeschränkte Erreichbarkeit über TCP 8080 entscheidend. Ergänzend nutzt UniFi TCP 8443 für Oberfläche und API sowie UDP 3478 für STUN.
Welche Geräte unterstützen Zero-Touch Provisioning?
Laut Ubiquiti wird ZTP derzeit von U7-Pro-Max-Access-Points unterstützt, weitere Geräte sollen folgen. Wichtig: Der ZTP-Code bleibt nur erhalten, wenn das Gerät nicht über die Hardware-Reset-Taste zurückgesetzt wird – Werksreset also immer über die UniFi-Verwaltungsoberfläche durchführen.
Warum verlieren meine Access Points nach der Adoption wieder die Verbindung?
Ein häufiger Grund ist ein Inform-Host, den die Geräte aus ihrem Netz heraus nicht auflösen oder erreichen können. In der UniFi-Anwendung lässt sich der Inform-Host mit einem festen Hostnamen oder einer festen IP überschreiben; die Namensauflösung dafür muss zuverlässig funktionieren. Änderungen direkt an den Konfigurationsdateien der Geräte helfen nicht – der Controller überschreibt sie wieder.