https://techcorner.max-it.de/index.php?action=history&feed=atom&title=UniFi%3A_Ger%C3%A4te_adoptieren_und_zur%C3%BCcksetzenUniFi: Geräte adoptieren und zurücksetzen - Versionsgeschichte2026-10-19T05:23:13ZVersionsgeschichte dieser Seite in maxTechCornerMediaWiki 1.43.9https://techcorner.max-it.de/index.php?title=UniFi:_Ger%C3%A4te_adoptieren_und_zur%C3%BCcksetzen&diff=4587&oldid=previmported>TechCorner-Redaktion: Neuer Artikel: Adoption, set-inform, DHCP-Option 43, ZTP, Werksreset, Gerätetausch2026-10-16T00:00:00Z<p>Neuer Artikel: Adoption, set-inform, DHCP-Option 43, ZTP, Werksreset, Gerätetausch</p>
<p><b>Neue Seite</b></p><div>{{Steckbrief<br />
| gilt_fuer = UniFi-Switches und Access Points an Cloud Gateway, CloudKey, UniFi OS Server oder Official UniFi Hosting; UniFi Network 10.x<br />
| bereich = Netzwerk-Hardware<br />
| dauer = ca. 5 Minuten je Gerät, Layer-3-Adoption ca. 15 Minuten<br />
| rechte = Administrator in UniFi Network; für set-inform SSH-Zugang zum Gerät<br />
| stand = Oktober 2026<br />
}}<br />
'''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.<br />
<br />
[[Datei:UniFi-Geraete-adoptieren.png|thumb|center|750px|Adoption von UniFi-Geräten: Im selben Netz erscheint das Gerät automatisch zur Übernahme; in anderen Netzen findet es UniFi Network per set-inform über SSH, DHCP-Option 43 oder den DNS-Namen unifi, jeweils über TCP-Port 8080. Ein Gerät im Werkszustand leuchtet dauerhaft weiß.]]<br />
<br />
== So funktioniert die Adoption ==<br />
* 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'').<br />
* 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.<br />
* Ab dann ist das Gerät an diese Instanz gebunden. Eine andere Instanz zeigt es als ''Managed by Other'' an.<br />
<br />
== Standardfall: Gerät im selben Netz ==<br />
# Gerät anschließen; Switches und APs bekommen per DHCP eine Adresse im Standardnetz (bzw. im nativen VLAN des Ports).<br />
# In UniFi Network unter ''UniFi Devices'' erscheint es als ''Pending Adoption'' bzw. ''Ready to Adopt''; alternativ zeigt die UniFi-App es an.<br />
# ''Adopt'' klicken und warten, bis der Status ''Online'' ist. Bei älterer Firmware folgt automatisch ein Update.<br />
<br />
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.<br />
<br />
{{Hinweis|Switches und Access Points nutzen für die Verwaltung das '''native (untagged) VLAN''' ihres Uplink-Ports – ab Werk also das Standardnetz. Ein Management-VLAN lässt sich später per ''Network Override'' in den Geräteeinstellungen festlegen. Dabei muss dieses VLAN auf allen Ports bis zum Gateway erlaubt sein, sonst ist das Gerät nicht mehr erreichbar.}}<br />
<br />
== Layer-3-Adoption: anderes Netz oder anderer Standort ==<br />
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.<br />
<br />
=== Variante A: set-inform per SSH ===<br />
<syntaxhighlight lang="bash"><br />
ssh ui@10.20.1.25 # Standard-Zugangsdaten im Werkszustand: ui / ui<br />
set-inform http://10.10.1.1:8080/inform<br />
</syntaxhighlight><br />
* Ältere Geräte nutzen <code>ubnt</code> / <code>ubnt</code>.<br />
* Nach dem Befehl in UniFi Network bzw. im Site Manager ''Adopt'' klicken. Wechselt das Gerät danach auf ''Adopting'' und bleibt hängen, <code>set-inform</code> einmal wiederholen.<br />
* Bei Official UniFi Hosting liefert ''Copy Inform URL'' im Dashboard die richtige Adresse.<br />
<br />
=== Variante B: DHCP-Option 43 ===<br />
Für ganze Standorte bequemer: Der DHCP-Server teilt den Geräten die Adresse mit.<br />
* '''UniFi-Gateway:''' unter ''Settings › Networks › [Netz] › Option 43'' die IP-Adresse der Verwaltung eintragen.<br />
* '''Anderer DHCP-Server:''' Option 43 als Hex-Wert: <code>0104</code> gefolgt von der IP-Adresse in Hex. Beispiel für 192.168.3.10: <code>0104c0a8030a</code>.<br />
<br />
=== Variante C: DNS ===<br />
Den Namen <code>unifi</code> im lokalen DNS auf die Adresse der Verwaltung auflösen lassen. Geräte im Werkszustand fragen diesen Namen ab.<br />
<br />
=== Variante D: Zero-Touch Provisioning ===<br />
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.<br />
<br />
== Access Points per Funk anbinden (Mesh) ==<br />
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.<br />
<br />
== Werksreset ==<br />
{| class="wikitable"<br />
! Weg !! Wirkung<br />
|-<br />
| '''''Forget''''' in UniFi Network (Gerät › Settings › Manage) || entfernt das Gerät aus der Verwaltung '''und''' setzt es zurück – der empfohlene Weg<br />
|-<br />
| '''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<br />
|}<br />
* Zu kurz gedrückt bewirkt nur einen Neustart, deutlich zu lang startet den TFTP-Wiederherstellungsmodus.<br />
* Die Lage der Reset-Taste zeigt ''techspecs.ui.com''.<br />
* Geräte mit ZTP-Code möglichst über ''Forget'' zurücksetzen, damit der Code gültig bleibt.<br />
<br />
== „Managed by Other“ ==<br />
Das Gerät gehört noch zu einer anderen Instanz – häufig nach dem Zurücksetzen des Gateways ohne Backup. Lösungen:<br />
# Gateway aus einem Backup zurückspielen, in dem das Gerät schon verwaltet war.<br />
# Gerät zurücksetzen und neu adoptieren.<br />
# Über die UniFi-App neu zuordnen – nur durch den Besitzer, der vorher in der App angemeldet war.<br />
<br />
== Defektes Gerät tauschen ==<br />
Mit ''Set Replacement Device'' übernimmt ein Ersatzgerät '''gleichen Modells''' automatisch die Konfiguration des alten (IP-Einstellungen, Funkeinstellungen, VLANs, Port-Profile):<br />
# ''UniFi Devices'' › altes Gerät › ''Settings'' › ''Set Replacement Device''.<br />
# Ersatz auswählen oder seine MAC-Adresse eintragen.<br />
# Altes Gerät abbauen (Status ''Offline'', '''nicht''' ''Forget''), Ersatz anschließen.<br />
Sobald das neue Gerät erreichbar ist, wird es automatisch adoptiert und konfiguriert.<br />
<br />
== Umzug auf eine neue Verwaltung ==<br />
* Gateway oder CloudKey per '''System-Backup''' auf das neue Gerät übertragen – die adoptierten Geräte verbinden sich dann von selbst neu.<br />
* Von einer selbst gehosteten Instanz: Network-Backup (<code>.unf</code>) 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.<br />
* SSH-Zugangsdaten der Geräte vorher aus der alten Instanz notieren.<br />
<br />
== Hinweise ==<br />
* '''Firmware:''' Sehr alte Firmware kann die Adoption verhindern. Dann das Gerät zunächst per SSH aktualisieren (Befehl <code>upgrade <Download-Link></code>) – nur als Ausnahme.<br />
* '''Gerät offline?''' Schrittweise Prüfung im [[UniFi: Fehlersuche-Leitfaden]].<br />
* '''Nichts lokal konfigurieren:''' Änderungen per SSH auf adoptierten Geräten werden überschrieben.<br />
* Bei Rollout, Austausch und Überwachung Ihrer UniFi-Geräte unterstützen Sie die [https://www.max-it.de/it-services/managed-services/ Managed Services von m.a.x. it].<br />
<br />
== Siehe auch ==<br />
* [[Ubiquiti UniFi]] – Überblick und alle Artikel der Reihe<br />
* [[UniFi: Cloud Gateway einrichten]]<br />
* [[UniFi: VLANs einrichten]]<br />
* [[UniFi: Switch-Ports und Port-Profile konfigurieren]]<br />
<br />
== Links und Quellen ==<br />
* [https://help.ui.com/hc/en-us/articles/204909754-Remote-Adoption-Layer-3 Ubiquiti Help Center: Remote Adoption (Layer 3)]<br />
* [https://www.max-it.de/it-services/managed-services/ Managed Services von m.a.x. it]<br />
<br />
{{Uebermax}}<br />
[[Kategorie:Netzwerk-Hardware]]<br />
</div>imported>TechCorner-Redaktion