Drei Jahre lang lief mein U6 Lite klaglos, und dann von heute auf morgen: Adoption Failed. 😤 Kein Firmware-Update, kein Kabelwechsel, nichts hatte ich angefasst. Der AP hat einfach aufgehört zu funktionieren. Ich hab als erstes natürlich das Kabel gecheckt, dann einen Neustart versucht, dann den üblichen Internetsuchdurchlauf. Alles ohne Ergebnis. Bis ich gemerkt habe, dass die IP-Adresse des APs im Controller auf etwas sehr Verdächtiges zeigt.
UniFi Adoption Failed mit UDM Pro entsteht oft, weil der Controller eine veraltete IP für den AP gespeichert hat, und beim SSH-Versuch sich selbst kontaktiert. Fix: echte IP des APs per PuTTY herausfinden, SSH rein, set-inform ausführen, fertig.
Das Problem: Adoption Failed beim U6 Lite 🤔
Mein Setup läuft auf einer UDM Pro als Gateway und Controller. Fünf APs im Haus, alles UniFi, alles bisher problemlos. Der U6 Lite hatte drei Jahre ohne eine einzige Auffälligkeit seinen Dienst getan, bis er es eines Morgens einfach nicht mehr tat. Im UniFi Dashboard: Adoption Failed. Kein Warnzeichen vorher, kein langsames Sterben.
Was mir aber auffiel: Wenn ich im Browser die IP-Adresse aufgerufen habe, die der Controller für diesen AP angezeigt hat, landete ich auf dem Hotspot-Portal der UDM Pro, also auf 192.168.1.1. Der Controller hat im Grunde versucht, sich selbst zu adopten. Das ist natürlich grandios schiefgelaufen. 😅
Die Ursache: Der Controller kennt die falsche IP 🕵️
Was passiert da genau? Kurz erklärt:
UniFi-Geräte bekommen in den meisten Heimnetzwerken ihre IP-Adresse per DHCP zugewiesen. Das bedeutet: Jedes Mal wenn ein AP neu startet oder das DHCP-Lease abläuft, kann er eine andere IP bekommen. Wenn der Controller die alte IP noch gecacht hat und das Gerät jetzt unter einer neuen Adresse erreichbar ist, schickt er die SSH-Adoptionsanfrage ins Leere, oder schlimmer noch: an ein anderes Gerät.
In meinem Fall war das noch dramatischer: Die alte IP zeigt auf 192.168.1.1, die Adresse der UDM Pro selbst. Der Controller hat also beim Adoptionsversuch die SSH-Verbindung zu sich selbst aufgebaut, auf die eigene Management-Oberfläche getroffen und, wenig überraschend, Adoption Failed zurückbekommen.
Wichtig: Das ist kein Fehler des APs, das Gerät selbst ist völlig in Ordnung. Das Problem liegt ausschließlich daran, dass der Controller nicht weiß, unter welcher IP der AP gerade erreichbar ist.
Schritt 1: Die echte IP des APs herausfinden 🔍
Bevor wir irgendwas über SSH machen können, brauchen wir die tatsächliche IP-Adresse des APs, nicht die, die der Controller glaubt zu kennen.
Option A: DHCP-Lease-Tabelle der UDM Pro
In der UDM Pro unter Settings → Networks → LAN gibt es eine DHCP-Lease-Übersicht. Den neuen AP findest du dort über den Hostnamen (meist U6-Lite) oder über die MAC-Adresse, die auf dem Gerät aufgedruckt ist.
Option B: UniFi Network App In der mobilen App unter Clients taucht der AP oft auch als unbekannter Client auf. Die zugewiesene IP steht direkt dabei.
Option C: ARP-Tabelle
Auf einem Windows-PC im selben Netz: arp -a in der PowerShell ausführen. Der neue AP taucht dort als unbekanntes Gerät auf.
Schritt 2: SSH-Passwort aus dem UniFi Controller holen 🔑
Das SSH-Passwort für UniFi-Geräte hat Ubiquiti in neueren Versionen verschoben. Es steckt nicht mehr unter den üblichen System-Einstellungen, sondern hier:
Settings → Devices → Device SSH
Dort findest du das aktuelle SSH-Passwort, das für alle deine Geräte gilt. Den Benutzernamen lässt du auf ubnt (oder deinen Admin-Namen).
Falls du PuTTY noch nicht installiert hast: Einfach die Exe von der offiziellen Seite laden, kein Installer nötig. Alternativ geht auch die Windows-eigene PowerShell mit ssh ubnt@{IP}.
Schritt 3: SSH-Verbindung zum AP aufbauen 💻
Jetzt verbinden wir uns direkt mit dem AP, an der IP, die wir in Schritt 1 herausgefunden haben, also nicht der aus dem Controller. In PuTTY trägst du die IP des APs ein, Port 22, und verbindest dich.
Nach dem Login siehst du das UniFi-Prompt:
BZ.v6.6.62# Das bestätigt: Wir sind auf dem richtigen Gerät. Falls stattdessen eine Web-Oberfläche oder ein anderes Gerät antwortet, nochmal die IP prüfen.
Schritt 4: set-inform ausführen ✅
Jetzt der eigentliche Fix. Ein einzelner Befehl weist den AP an, den Controller unter seiner echten IP zu kontaktieren:
set-inform http://192.168.1.1:8080/informErsetze 192.168.1.1 durch die tatsächliche IP deiner UDM Pro oder deines Controllers. Das Gerät antwortet mit:
Adoption request sent to 'http://192.168.1.1:8080/inform'.
Use the controller to complete the adopt process.Zurück im UniFi Dashboard: Der AP taucht jetzt als Pending Adoption auf. Einmal auf „Adopt" klicken, und nach 30–60 Sekunden ist das Gerät online und vollständig provisioniert. 🎉
Prävention: Statische DHCP-Reservierung einrichten 🛡️
Das Problem kann wiederkehren, sobald das DHCP-Lease des APs abläuft und er eine neue IP bekommt. Die sauberste Lösung: feste IP-Adressen für alle UniFi-Geräte per DHCP-Reservierung.
In der UDM Pro geht das so:
- Settings → Networks → LAN öffnen
- Unter DHCP auf Add Fixed IP klicken
- MAC-Adresse des APs eintragen (steht auf dem Gerät und im DHCP-Lease)
- Gewünschte feste IP vergeben (z.B.
192.168.1.153) - Speichern, ab dem nächsten DHCP-Renew bekommt der AP immer diese IP
So hat der Controller immer eine verlässliche Adresse und kann Adoption-Probleme dieser Art gar nicht erst entstehen lassen.
Häufige Fragen ❓
Warum zeigt UniFi Adoption Failed, obwohl das Gerät im Netz sichtbar ist?
Der häufigste Grund ist eine veraltete oder falsche IP im Controller. Das Gerät ist erreichbar, aber nicht unter der Adresse, die der Controller erwartet. Mit set-inform gibst du dem AP explizit die richtige Controller-Adresse, unabhängig davon, was im Controller gespeichert ist.
Was macht der Befehl set-inform genau?
set-inform weist den UniFi-Access-Point an, sich aktiv beim Controller unter der angegebenen URL zu melden. Normalerweise findet der AP den Controller automatisch per DNS (http://unifi:8080/inform). Wenn das nicht funktioniert, zum Beispiel weil kein entsprechender DNS-Eintrag existiert, übernimmt set-inform manuell.
Wo finde ich das SSH-Passwort für UniFi-Geräte in neueren Versionen?
Das SSH-Passwort ist seit einigen UniFi-Versionen verschoben worden und liegt jetzt unter Settings → Devices → Device SSH. In älteren Versionen war es unter System → Advanced zu finden.
Muss ich den AP vorher auf Werkseinstellungen zurücksetzen?
Nein, das ist der Vorteil dieser Methode. Ein Factory Reset ist nur nötig, wenn das Gerät bereits von einem anderen Controller adoptiert wurde. Bei frischen Geräten oder Geräten die nie erfolgreich adoptiert wurden, reicht set-inform vollständig aus.
Was passiert, wenn set-inform nichts bewirkt?
Dann den Befehl nochmal ausführen, manchmal braucht der AP zwei Versuche. Wenn das immer noch nicht hilft, prüfen ob Port 8080 zwischen AP und Controller erreichbar ist. Als letztes Mittel hilft ein Factory Reset über den Reset-Knopf am Gerät (10 Sekunden halten bis die LED blinkt).
Fazit 🎯
UniFi Adoption Failed beheben klingt erstmal nach einem komplexen Netzwerkproblem, ist es aber oft gar nicht. In meinem Fall war die Ursache simpel: Der Controller hatte eine veraltete IP gespeichert und hat beim Adoptionsversuch seine eigene Oberfläche angesprochen. Ein SSH-Login in den AP, ein einziger Befehl mit set-inform, und das Problem war in zwei Minuten Geschichte.
Und mit einer statischen DHCP-Reservierung für alle UniFi-Geräte stellst du sicher, dass so ein Szenario gar nicht mehr auftreten kann. Et voilà. 🎉