Ein neuer Access Point ist ausgepackt, angeschlossen – und taucht im Controller einfach nicht auf. Oder er erscheint kurz, bleibt dann aber hängen, meldet „Managed by Other“ oder fällt nach der Adoption wieder offline. Adoption-Probleme gehören zu den häufigsten Stolpersteinen im UniFi-Alltag. Die gute Nachricht: Fast immer steckt eine von wenigen Ursachen dahinter. Dieser Ratgeber zeigt dir, wie du systematisch vorgehst und welche Lösung zu welchem Fehlerbild passt – gestützt auf die offizielle Ubiquiti-Dokumentation.
Schritt 1: Was sagt die LED?
Bevor du an Firewall oder DNS gehst, schau auf das Gerät. Die blau-weiße Status-LED verrät laut Ubiquiti bei Access Points, Switches und Routern schon viel über den Zustand:
| LED-Muster | Bedeutung |
|---|---|
| Weiß blinkend (an/aus im Halbsekundentakt) | Gerät startet noch – abwarten |
| Dauerhaft weiß | Bereit zur Adoption (Werkszustand) |
| Dauerhaft blau | Adoptiert, normaler Betrieb |
| Blau, alle 5 Sekunden kurz aus | Access Point hat die Netzwerkverbindung verloren und sucht einen WLAN-Uplink |
| Schnell weiß/blau blinkend | Firmware-Update läuft – nicht unterbrechen |
| Wechsel weiß–blau–aus | Gerät ist im TFTP-Modus (Recovery) |
| Aus | Gerät ist offline – Strom, PoE und Kabel prüfen |
Leuchtet die LED dauerhaft weiß, ist das Gerät bereit und wartet nur darauf, gefunden zu werden. Dann liegt das Problem fast immer im Netzwerk zwischen Gerät und Controller.
Fehler 1: Das Gerät erscheint gar nicht im Controller
Im einfachsten Fall hängen Gerät und UniFi-Network-Anwendung im selben VLAN. Dann sollte das Gerät von selbst als Pending Adoption auftauchen. Tut es das nicht, nennt Ubiquiti als ersten Prüfpunkt die Ports: TCP 8080 und UDP 10001 müssen zwischen UniFi-Host und Geräten offen sein – durch alle Gateways, Firewalls und Antiviren-Programme hindurch. Über TCP 8080 läuft die Kommunikation zwischen Gerät und Anwendung, über UDP 10001 die Discovery während der Adoption. Erst als letztes Mittel empfiehlt Ubiquiti, das Gerät zurückzusetzen und es erneut zu versuchen.
Liegen Gerät und Controller in verschiedenen VLANs oder Subnetzen – oder läuft der Controller an einem anderen Standort bzw. in der Cloud –, funktioniert die automatische Erkennung nicht. Dann brauchst du die Layer-3-Adoption über DNS, DHCP Option 43 oder set-inform. Wie das im Einzelnen geht, zeigt unser Ratgeber zur Layer-3-Adoption von Access Points.
Fehler 2: Das Gerät hat keine (richtige) IP-Adresse
Ohne gültige IP-Adresse kann kein Gerät seinen Controller erreichen. Prüfen kannst du das in UniFi Network unter Settings > Networks über den Link IP Leases neben dem betroffenen Netz oder mit der App WiFiman im Reiter Discovery. Ein einfacher Gegentest: Steck statt des UniFi-Geräts einen Laptop an dasselbe Kabel und denselben Port. Bekommt er keine Adresse oder nur eine APIPA-Adresse (169.254.x.x), liegt das Problem im Netz, nicht am Gerät.
Ubiquiti unterscheidet zwei Fälle:
- Keine IP oder die Fallback-Adresse 192.168.1.20: Prüfe das Port-Tagging am Switch und eventuelle Netzwerk-Overrides. Auch eine Netzwerkschleife kann die Ursache sein.
- Eine unerwartete IP-Adresse: Dann vergibt vermutlich ein fremder („rogue“) DHCP-Server im Netz Adressen. Findest du ihn nicht, kannst du in den Netzwerkeinstellungen DHCP Guarding aktivieren und die IP deines vertrauenswürdigen DHCP-Servers eintragen. DHCP-Angebote anderer Server werden dann blockiert. Voraussetzung dafür sind UniFi-Switches.
Fehler 3: Port 8080 ist auf dem Weg blockiert
Hat das Gerät eine korrekte IP und erscheint trotzdem nicht, können Gerät und Anwendung laut Ubiquiti wahrscheinlich nicht über TCP 8080 miteinander sprechen. Bei entfernten oder gehosteten Controllern ist das der häufigste Grund. Was zu tun ist, hängt vom Aufbau ab:
- Getrennte VLANs hinter demselben Gateway: Inter-VLAN-Routing aktivieren und sicherstellen, dass die Firewall TCP 8080 nicht blockiert.
- Gehosteter Controller oder Konsole mit öffentlicher IP: Die lokale Firewall bzw. das Gateway muss zulassen, dass das Gerät über TCP 8080 mit ihm kommuniziert.
- Controller hinter einem entfernten Gateway mit öffentlicher IP: TCP 8080 per Port-Forwarding an die interne IP des Controllers weiterleiten.
- Entferntes Gateway hat selbst nur eine private IP (Double NAT): Das funktioniert laut Ubiquiti nicht – hier hilft nur der Internetanbieter.
- Verbindung über VPN: Das Gerät ist logisch im selben Netz. Prüfe, dass intern keine Firewall TCP 8080 blockiert.
Ein häufiger Tippfehler bei der Inform-Adresse: Sie lautet http://<ip-oder-fqdn>:8080/inform – mit http, Port 8080 und dem Pfad /inform. Mehr zur Inform-URL und typischen Fallstricken findest du im Ratgeber set-inform und Override Inform Host.
Fehler 4: „Managed by Other“
Diese Meldung bedeutet: Das Gerät hält sich noch für verwaltet von einer anderen UniFi-Instanz. Typischer Auslöser ist laut Ubiquiti eine Konsole – etwa ein Cloud Key oder eine Dream Machine –, die auf Werkseinstellungen zurückgesetzt wurde. Die Geräte „erinnern“ sich dann an die alte Instanz. Ubiquiti nennt drei Lösungen:
- Die Konsole aus einem Backup wiederherstellen, in dem das Gerät bereits verwaltet war.
- Das Gerät auf Werkseinstellungen zurücksetzen und neu adoptieren.
- Das Gerät über die UniFi-Network-Mobile-App neu zuweisen. Das kann nur der Account-Owner, und er muss zuvor in der App angemeldet gewesen sein, während das Gerät verwaltet wurde.
Ein Sonderfall bei selbst gehosteten Installationen: Ubiquiti weist darauf hin, dass manche Nutzer die UniFi-Software auf mehreren Rechnern installieren, um das Netz von dort aus zu verwalten. Dabei entsteht jedes Mal eine komplett neue Instanz. Installiere die Software nur auf einem einzigen Server und greife von anderen Geräten über dessen Adresse darauf zu. Warum ein aktuelles Backup gerade hier Gold wert ist, liest du im Ratgeber UniFi Controller Backup & Wiederherstellung.
Fehler 5: Das Gerät landet beim falschen Controller
Ein Gerät kann seine Inform-Adresse auf mehreren Wegen erhalten: über DNS, DHCP Option 43, set-inform oder einen ZTP-Code. Ubiquiti stellt klar, dass das Gerät alle diese Optionen durchläuft – wer zuerst auflöst und antwortet, adoptiert das Gerät. Zeigt also noch ein alter DNS-Eintrag unifi oder eine veraltete Option 43 auf einen früheren Controller, kann das Gerät dort statt beim neuen landen. Räume nach jedem Controller-Wechsel DNS und DHCP auf.
Fehler 6: Der Access Point ist „Isolated“
„Isolated“ heißt: Der Access Point hat die Verbindung zur Konsole im Management-Netz verloren, wird aber noch von einem anderen, online befindlichen AP erkannt. Clients funktionieren oft weiter, weil der AP mit seiner letzten Konfiguration weiterläuft. Ubiquiti empfiehlt:
- Kabelgebundener AP: Zuerst kürzliche Änderungen an Switchports, Subnetzen oder Firewall-Regeln zurücknehmen – sie sind die wahrscheinlichste Ursache. Hilft das nicht, den AP zurücksetzen, in UniFi Network entfernen und neu adoptieren.
- Per Mesh angebundener AP: Die APs näher zusammenrücken, da zu schwaches Signal ein häufiger Grund ist. Danach ebenfalls zurücksetzen, entfernen und neu adoptieren. Bleibt das Problem, den AP kabelgebunden anschließen und auf die aktuelle Firmware bringen.
Fehler 7: Der Werksreset klappt nicht
Viele Lösungen enden mit „zurücksetzen und neu adoptieren“. Damit das gelingt, beachte die Hinweise von Ubiquiti:
- Den Reset-Taster je nach Modell 5 bis 10 Sekunden halten oder bis die LED den Reset anzeigt. Das Gerät muss dabei Strom haben.
- Zu kurz gedrückt, startet das Gerät nur neu. Zu lange gedrückt, landet es im TFTP-Recovery-Modus.
- Der Taster entfernt das Gerät nicht aus der Anwendung, in der es adoptiert war. Das erledigst du dort über Forget – was das Gerät zugleich auf Werkseinstellungen zurücksetzt.
Schnellübersicht: Symptom, Ursache, Lösung
| Symptom | Wahrscheinliche Ursache | Lösung |
|---|---|---|
| Gerät erscheint nicht (gleiches VLAN) | TCP 8080 / UDP 10001 blockiert | Firewall, Gateway, Antiviren-Software prüfen |
| Gerät erscheint nicht (anderes VLAN/Cloud) | Keine Layer-3-Adoption eingerichtet | DNS, DHCP Option 43 oder set-inform |
| Keine IP oder 192.168.1.20 | Port-Tagging, Network-Override, Schleife | Switchport-Konfiguration prüfen |
| Unerwartete IP | Fremder DHCP-Server | Server finden oder DHCP Guarding |
| „Managed by Other“ | Gerät gehört noch zu alter Instanz | Backup einspielen, Reset oder Neuzuweisung per App |
| Gerät landet beim alten Controller | Veralteter DNS-Eintrag oder Option 43 | DNS/DHCP aktualisieren |
| AP „Isolated“ | Geänderte Switch-/Firewall-Konfiguration, schwaches Mesh-Signal | Änderungen zurücknehmen, Reset, neu adoptieren |
Fazit
Die meisten Adoption-Fehler lassen sich in wenigen Schritten eingrenzen: LED ablesen, IP-Adresse prüfen, Erreichbarkeit über TCP 8080 sicherstellen. Erst wenn das alles stimmt, lohnt der Blick auf Sonderfälle wie „Managed by Other“ oder konkurrierende Inform-Quellen. Und der Werksreset ist das letzte, nicht das erste Mittel. Läuft dein UniFi Controller bei clevendo und du kommst trotzdem nicht weiter, findest du die passenden Anleitungen in unserem clevendo-Hilfebereich.
Häufige Fragen
Warum wird mein UniFi-Gerät nicht adoptiert?
Meist können Gerät und UniFi-Network-Anwendung nicht über TCP-Port 8080 kommunizieren, oder das Gerät hat keine gültige IP-Adresse. Liegen beide in verschiedenen Netzen, ist außerdem eine Layer-3-Adoption über DNS, DHCP Option 43 oder set-inform nötig.
Was bedeutet „Managed by Other“?
Das Gerät betrachtet sich noch als verwaltet von einer anderen UniFi-Instanz, zum Beispiel nach dem Zurücksetzen einer Konsole. Lösungen sind ein Restore aus einem Backup, ein Werksreset mit neuer Adoption oder die Neuzuweisung durch den Account-Owner in der UniFi-Network-Mobile-App.
Welche Ports braucht die UniFi-Adoption?
Laut Ubiquiti müssen TCP 8080 (Kommunikation zwischen Gerät und Anwendung) und UDP 10001 (Discovery während der Adoption) zwischen UniFi-Host und Geräten offen sein. Für die Adoption an einen entfernten oder gehosteten Controller ist die uneingeschränkte Erreichbarkeit über TCP 8080 entscheidend.
Was bedeutet die IP-Adresse 192.168.1.20?
Das ist die Fallback-IP, die ein UniFi-Gerät nutzt, wenn es keine Adresse per DHCP bekommt. Ubiquiti empfiehlt dann, das Switchport-Tagging, Netzwerk-Overrides und mögliche Netzwerkschleifen zu prüfen.
Reicht es, den Reset-Knopf zu drücken?
Für das Gerät ja, für die Anwendung nicht: Der Taster setzt das Gerät zurück, entfernt es aber nicht aus dem Controller, in dem es adoptiert war. Dort musst du es zusätzlich über „Forget“ entfernen.