UniFi: Geräte adoptieren und zurücksetzen
Auf einen Blick
| Gilt für | UniFi-Switches und Access Points an Cloud Gateway, CloudKey, UniFi OS Server oder Official UniFi Hosting; UniFi Network 10.x |
|---|---|
| Bereich | Netzwerk-Hardware |
| Dauer | ca. 5 Minuten je Gerät, Layer-3-Adoption ca. 15 Minuten |
| Rechte | Administrator in UniFi Network; für set-inform SSH-Zugang zum Gerät |
| Stand | Oktober 2026 |
UniFi-Geräte adoptieren heißt, einen Switch oder Access Point fest an eine UniFi-Network-Instanz zu binden. Erst danach erhält das Gerät seine Konfiguration, Firmware-Updates und Überwachung zentral. Im selben Netz geschieht das per Klick; liegen Gerät und Verwaltung in verschiedenen Netzen oder Standorten, braucht es die Layer-3-Adoption. Dieser Artikel zeigt alle Wege, die nötigen Ports, den Werksreset und den Tausch eines defekten Geräts.
So funktioniert die Adoption
- Ein Gerät im Werkszustand (LED dauerhaft weiß) sucht per Broadcast (UDP 10001) nach einer UniFi-Network-Instanz und meldet sich anschließend per HTTP an TCP 8080 (Inform).
- Nach dem Klick auf Adopt übernimmt UniFi Network das Gerät, ersetzt die Standard-Zugangsdaten durch die SSH-Zugangsdaten der Site, spielt Konfiguration und ggf. Firmware ein.
- Ab dann ist das Gerät an diese Instanz gebunden. Eine andere Instanz zeigt es als Managed by Other an.
Standardfall: Gerät im selben Netz
- Gerät anschließen; Switches und APs bekommen per DHCP eine Adresse im Standardnetz (bzw. im nativen VLAN des Ports).
- In UniFi Network unter UniFi Devices erscheint es als Pending Adoption bzw. Ready to Adopt; alternativ zeigt die UniFi-App es an.
- Adopt klicken und warten, bis der Status Online ist. Bei älterer Firmware folgt automatisch ein Update.
Erscheint das Gerät nicht: Zwischen Gerät und Verwaltung müssen TCP 8080 und UDP 10001 frei sein (auch Virenscanner und Desktop-Firewalls bei selbst gehosteten Instanzen prüfen). Als letztes Mittel das Gerät zurücksetzen.
Layer-3-Adoption: anderes Netz oder anderer Standort
Liegt das Gerät in einem anderen Subnetz oder an einem anderen Standort, muss man ihm sagen, wo UniFi Network erreichbar ist. Voraussetzung ist eine freie Verbindung über TCP 8080 vom Gerät zur Verwaltung.
Variante A: set-inform per SSH
ssh ui@10.20.1.25 # Standard-Zugangsdaten im Werkszustand: ui / ui
set-inform http://10.10.1.1:8080/inform
- Ältere Geräte nutzen
ubnt/ubnt. - Nach dem Befehl in UniFi Network bzw. im Site Manager Adopt klicken. Wechselt das Gerät danach auf Adopting und bleibt hängen,
set-informeinmal wiederholen. - Bei Official UniFi Hosting liefert Copy Inform URL im Dashboard die richtige Adresse.
Variante B: DHCP-Option 43
Für ganze Standorte bequemer: Der DHCP-Server teilt den Geräten die Adresse mit.
- UniFi-Gateway: unter Settings › Networks › [Netz] › Option 43 die IP-Adresse der Verwaltung eintragen.
- Anderer DHCP-Server: Option 43 als Hex-Wert:
0104gefolgt von der IP-Adresse in Hex. Beispiel für 192.168.3.10:0104c0a8030a.
Variante C: DNS
Den Namen unifi im lokalen DNS auf die Adresse der Verwaltung auflösen lassen. Geräte im Werkszustand fragen diesen Namen ab.
Variante D: Zero-Touch Provisioning
Neuere Geräte (u. a. U7 Pro Max, U7 Pro XG/XGS, U7 Lite, U7 LR, E7) tragen einen ZTP-Code auf dem Karton. Wird er im Site Manager einer Site zugeordnet, adoptiert sich das Gerät am Zielort selbst. Voraussetzung: UniFi Network 8.2.71 und UniFi OS 4.0 oder neuer. Der Code bleibt gültig, solange das Gerät nicht per Reset-Taste zurückgesetzt wird.
Access Points per Funk anbinden (Mesh)
Ein AP ohne Kabelverbindung kann sich per Funk an einen verkabelten AP anhängen: Wireless Meshing unter Settings › WiFi einschalten und den neuen AP in der Nähe des Uplink-APs adoptieren. Jede Funkstrecke halbiert etwa den Durchsatz – Mesh ist eine Notlösung. Wird kein Mesh genutzt, die Funktion abschalten, um Schleifen zu vermeiden.
Werksreset
| Weg | Wirkung |
|---|---|
| Forget in UniFi Network (Gerät › Settings › Manage) | entfernt das Gerät aus der Verwaltung und setzt es zurück – der empfohlene Weg |
| Reset-Taste 5–10 Sekunden halten (Gerät eingeschaltet lassen) | setzt nur das Gerät zurück; der Eintrag in UniFi Network bleibt bestehen und muss dort entfernt werden |
- Zu kurz gedrückt bewirkt nur einen Neustart, deutlich zu lang startet den TFTP-Wiederherstellungsmodus.
- Die Lage der Reset-Taste zeigt techspecs.ui.com.
- Geräte mit ZTP-Code möglichst über Forget zurücksetzen, damit der Code gültig bleibt.
„Managed by Other“
Das Gerät gehört noch zu einer anderen Instanz – häufig nach dem Zurücksetzen des Gateways ohne Backup. Lösungen:
- Gateway aus einem Backup zurückspielen, in dem das Gerät schon verwaltet war.
- Gerät zurücksetzen und neu adoptieren.
- Über die UniFi-App neu zuordnen – nur durch den Besitzer, der vorher in der App angemeldet war.
Defektes Gerät tauschen
Mit Set Replacement Device übernimmt ein Ersatzgerät gleichen Modells automatisch die Konfiguration des alten (IP-Einstellungen, Funkeinstellungen, VLANs, Port-Profile):
- UniFi Devices › altes Gerät › Settings › Set Replacement Device.
- Ersatz auswählen oder seine MAC-Adresse eintragen.
- Altes Gerät abbauen (Status Offline, nicht Forget), Ersatz anschließen.
Sobald das neue Gerät erreichbar ist, wird es automatisch adoptiert und konfiguriert.
Umzug auf eine neue Verwaltung
- Gateway oder CloudKey per System-Backup auf das neue Gerät übertragen – die adoptierten Geräte verbinden sich dann von selbst neu.
- Von einer selbst gehosteten Instanz: Network-Backup (
.unf) einspielen und in der alten Instanz Override Inform Host mit der Adresse der neuen setzen. Geräte, die danach offline bleiben, zurücksetzen und neu adoptieren. - SSH-Zugangsdaten der Geräte vorher aus der alten Instanz notieren.
Hinweise
- Firmware: Sehr alte Firmware kann die Adoption verhindern. Dann das Gerät zunächst per SSH aktualisieren (Befehl
upgrade <Download-Link>) – nur als Ausnahme. - Gerät offline? Schrittweise Prüfung im UniFi: Fehlersuche-Leitfaden.
- Nichts lokal konfigurieren: Änderungen per SSH auf adoptierten Geräten werden überschrieben.
- Bei Rollout, Austausch und Überwachung Ihrer UniFi-Geräte unterstützen Sie die Managed Services von m.a.x. it.
Siehe auch
- Ubiquiti UniFi – Überblick und alle Artikel der Reihe
- UniFi: Cloud Gateway einrichten
- UniFi: VLANs einrichten
- UniFi: Switch-Ports und Port-Profile konfigurieren
Links und Quellen
Über m.a.x. it Die m.a.x. Informationstechnologie AG ist seit über 30 Jahren IT-Partner mittelständischer und großer Unternehmen in München und bietet maßgeschneiderte Lösungen und Services in den Bereichen Cloud, Cybersecurity, Netzwerk, Windows, Linux und Softwareentwicklung. Sie haben eine Frage zu diesem Artikel oder brauchen Unterstützung?
