Ein UniFi-Gerät meldet sich nur dann beim richtigen Controller, wenn es die richtige Inform-URL kennt. Im selben Netz wie der Controller klappt das von allein. Liegt der Controller aber in einem anderen VLAN, an einem anderen Standort oder in der Cloud – oder ziehst du ihn gerade um –, musst du nachhelfen. Dafür gibt es zwei Werkzeuge, die ähnlich klingen, aber an ganz verschiedenen Stellen ansetzen: den Befehl set-inform direkt auf dem Gerät und den Schalter „Override Inform Host“ in der UniFi-Network-Anwendung. Dieser Ratgeber zeigt dir, was beide tun, wann du welches brauchst und wo es in der Praxis hakt.
Was ist die Inform-URL?
UniFi-Geräte wie Access Points und Switches sprechen mit der Network-Anwendung über TCP-Port 8080. Ubiquiti führt ihn in der offiziellen Portübersicht als Port für die Kommunikation zwischen Gerät und Anwendung. Die Adresse, an die sich ein Gerät dabei wendet, ist die Inform-URL. Sie folgt immer demselben Schema:
http://<ip-adresse-oder-fqdn>:8080/inform
Statt einer IP-Adresse kannst du laut Ubiquiti auch einen vollqualifizierten Hostnamen (FQDN) verwenden. Achte auf die Details: http:// am Anfang, Port 8080 und der Pfad /inform am Ende.
Ein noch nicht adoptiertes Gerät kann seine Inform-Adresse auf mehreren Wegen erhalten: über einen DNS-Eintrag für den Hostnamen unifi, über DHCP Option 43, über einen ZTP-Code oder manuell per set-inform. Ubiquiti weist darauf hin, dass ein Gerät alle diese Inform-Optionen durchläuft und versucht, sich bei jeder davon adoptieren zu lassen – wer zuerst auflöst und antwortet, bekommt das Gerät. Halte DNS-Einträge und DHCP-Optionen deshalb aktuell, wenn du den Controller wechselst. Wie die einzelnen Adoptionswege im Detail funktionieren, erklärt unser Ratgeber zur Layer-3-Adoption von Access Points.
set-inform: die Adresse direkt auf dem Gerät setzen
Mit set-inform teilst du einem einzelnen Gerät per Kommandozeile mit, wo sein Controller läuft. Ubiquiti beschreibt diesen Weg für neue Netze, in denen noch kein WLAN zur Verfügung steht, und allgemein als letztes Mittel, wenn die Adoption auf anderem Weg nicht gelingt.
Voraussetzungen
- Das Gerät befindet sich im Werkszustand. Erkennbar ist das laut Ubiquiti an einer dauerhaft weiß leuchtenden LED.
- Du bist mit einem Laptop per Kabel im selben lokalen Netz wie das Gerät – SSH funktioniert nur von dort.
- Du kennst die IP-Adresse des Geräts, zum Beispiel aus den DHCP-Leases deines Routers. Mit einem UniFi Gateway findest du sie unter Settings > Networks über den Link IP Leases.
- TCP-Port 8080 ist zwischen Gerät und Controller uneingeschränkt erreichbar.
Schritt für Schritt
- Verbinde dich per SSH mit dem Gerät:
ssh ui@<ip-des-geräts>. Im Werkszustand gelten die Standard-Zugangsdatenui/ui, bei älteren Gerätenubnt/ubnt. - Setze die Inform-URL:
set-inform http://<ip-oder-fqdn>:8080/inform - Öffne den UniFi Site Manager oder die UniFi Mobile App. Das Gerät taucht dort zur Adoption auf, und du übernimmst es wie gewohnt.
- Klappt die Übernahme nicht auf Anhieb, setze den Befehl mit derselben URL noch einmal ab. Ubiquiti weist ausdrücklich darauf hin, dass du ihn eventuell wiederholen musst, nachdem das Gerät in UniFi erschienen ist.
Tipp für gehostete Controller: Bei Official UniFi Hosting findest du im Dashboard der Network-Anwendung die Schaltfläche Copy Inform URL; die kopierte Adresse setzt du direkt in den Befehl ein. Nutzt du einen anderen gehosteten Controller, bekommst du die Adresse von deinem Anbieter.
SSH-Zugangsdaten nach der Adoption
Die Standard-Zugangsdaten gelten nur vor der Einrichtung beziehungsweise Adoption. Danach bestehen die SSH-Zugangsdaten von UniFi-Netzwerkgeräten aus einer zufälligen Zeichenfolge. Einsehen und ändern kannst du sie in UniFi Network unter UniFi Devices > Device Updates and Settings (unten links) im Bereich Device SSH Settings bei Device SSH Authentication. Ubiquiti empfiehlt, sie vor einem Controller-Umzug zu notieren – für den Fall, dass einzelne Geräte später beim Verbinden mit dem neuen Controller Hilfe brauchen.
Gut zu wissen: Für den direkten Zugriff auf ein Gerät empfiehlt Ubiquiti grundsätzlich die Debug-Konsole in UniFi Network (Gerät auswählen > Settings > ganz unten Debug) und SSH nur erfahrenen Nutzern. Die Debug-Konsole braucht allerdings ein funktionierendes UniFi OS.
Override Inform Host: alle Geräte auf einen neuen Controller umlenken
Während set-inform auf einem einzelnen Gerät ansetzt, arbeitet „Override Inform Host“ von der Controller-Seite aus. Den Schalter aktivierst du in der bisherigen Network-Anwendung und trägst dort die Adresse des neuen Hosts ein. Damit sagt die alte Anwendung den Geräten, wohin sie sich künftig verbinden sollen – ohne dass du jedes Gerät einzeln per SSH anfassen musst.
Ubiquiti sieht das für Geräte vor, die zuvor per DNS, DHCP Option 43 oder Layer-3-Befehlen an einen selbst gehosteten UniFi Network Server oder einen Cloud Key adoptiert wurden.
Ablauf laut Ubiquiti-Anleitung
- Stelle sicher, dass die neue Network-Anwendung auf dem aktuellen Stand ist.
- Lade in der alten Anwendung unter Settings > Control Plane > Backups die Network-Backup-Datei (
*.unf) herunter. - Richte den neuen Host ein und spiele das Backup dort unter Settings > Control Plane > Backups ein. Die UniFi-Geräte bleiben dabei angeschlossen wie bisher.
- Aktiviere nach dem Restore in der alten Anwendung den Schalter Override Inform Host und trage die Adresse des neuen Hosts ein.
- Passe DNS-Einträge an anderen Standorten an, die noch auf den alten Controller zeigen.
- Warte, bis alle Geräte in der neuen Anwendung online sind. Erscheint ein Gerät offline oder als „Managed by Another Console“, setze es auf Werkseinstellungen zurück und adoptiere es neu.
- Entferne die umgezogenen Geräte anschließend in der alten Anwendung über Forget und fahre die alte Instanz herunter.
Halte die Reihenfolge ein: Forget entfernt ein Gerät laut Ubiquiti nicht nur aus der Verwaltung, sondern setzt es auch auf Werkseinstellungen zurück. Wie du das Backup sauber erstellst, liest du in unserem Ratgeber zu Backup und Wiederherstellung, den kompletten Umzug beschreibt die Anleitung UniFi Controller in die Cloud umziehen.
Was gehört in das Feld? Nur die Adresse des neuen Hosts, keine vollständige Inform-URL. Ubiquiti spricht von der IP-Adresse des neuen Hosts. Ziehst du zu Official UniFi Hosting um, nimmst du die Inform-URL aus dem Dashboard und entfernst das führende http:// sowie das abschließende :8080/inform.
Grenze des Schalters: Er sitzt in der alten Anwendung. Ist der alte Controller bereits weg, etwa nach einem Hardware-Defekt, kannst du ihn nicht mehr nutzen. Dann bleiben DNS, DHCP Option 43 oder set-inform – mehr dazu im Ratgeber Cloud Key ausgefallen oder gestohlen.
set-inform oder Override Inform Host – was brauchst du wann?
| set-inform | Override Inform Host | DNS „unifi“ / DHCP Option 43 | |
|---|---|---|---|
| Wo wird es gesetzt? | Auf dem Gerät per SSH | In der bisherigen Network-Anwendung | Im lokalen DNS- bzw. DHCP-Server |
| Typischer Einsatz | Einzelne Geräte, neue Netze ohne WLAN, letzter Ausweg | Umzug der Geräte eines laufenden Controllers auf einen neuen Host | Mehrere neue oder zurückgesetzte Geräte |
| Voraussetzung | Zugang im lokalen Netz, SSH-Zugangsdaten | Alte Anwendung läuft noch | Kontrolle über DNS bzw. DHCP |
| Gemeinsam | TCP-Port 8080 muss zwischen Gerät und Controller uneingeschränkt erreichbar sein | ||
Wenn die Geräte nicht ankommen: Fehlersuche
Hakt es, können Gerät und Network-Anwendung laut Ubiquiti wahrscheinlich nicht über TCP-Port 8080 miteinander kommunizieren. Wie du das löst, hängt davon ab, wo der Controller läuft:
| Situation | Was zu tun ist |
|---|---|
| Controller und Gerät in verschiedenen VLANs hinter demselben Gateway | Inter-VLAN-Routing aktivieren, TCP 8080 in der Firewall nicht blockieren |
| Official UniFi Hosting oder Controller mit eigener öffentlicher IP | Lokale Firewall bzw. Gateway muss die Verbindung des Geräts über TCP 8080 zulassen |
| Controller hinter einem entfernten Gateway mit öffentlicher IP | Port-Forwarding von TCP 8080 auf die interne IP des Controllers |
| Entferntes Gateway hat selbst nur eine private IP (Double NAT) | Funktioniert laut Ubiquiti so nicht – Internetanbieter kontaktieren |
| Verbindung über VPN | Gerät ist logisch im selben Netz; sicherstellen, dass intern keine Firewall TCP 8080 blockiert |
Weitere Stolpersteine
- „Managed by Other“: Das Gerät hält sich noch für verwaltet von einer anderen UniFi-Instanz – etwa weil die frühere Konsole auf Werkseinstellungen zurückgesetzt wurde. Ubiquiti nennt drei Auswege: die Konsole aus einem Backup wiederherstellen, in dem das Gerät bereits verwaltet war; das Gerät zurücksetzen und neu adoptieren; oder es über die UniFi-Network-Mobile-App neu zuweisen. Letzteres kann nur der Account-Owner, und er muss zuvor in der App angemeldet gewesen sein, während das Gerät verwaltet wurde.
- Keine passende IP-Adresse: Hat das Gerät gar keine Adresse oder die Fallback-IP
192.168.1.20, liegt das Problem vor dem Inform. Prüfe Switchport-Tagging, Netzwerk-Overrides und mögliche Netzwerkschleifen. Eine unerwartete IP deutet auf einen fremden DHCP-Server im Netz hin. - Reset-Taste allein reicht nicht: Der Taster setzt das Gerät zurück (je nach Modell 5 bis 10 Sekunden halten, das Gerät muss dabei Strom haben). Aus der Anwendung, in der es adoptiert war, verschwindet es dadurch aber nicht – das erledigst du dort über Forget.
Fazit
set-inform und „Override Inform Host“ lösen dasselbe Problem von zwei Seiten: set-inform setzt die Inform-URL auf einem einzelnen Gerät, „Override Inform Host“ lenkt die Geräte eines noch laufenden Controllers auf einen neuen Host um. Beides funktioniert nur, wenn TCP-Port 8080 zwischen Gerät und Controller frei ist – dort solltest du bei Problemen immer zuerst suchen. Die Adresse gehört in set-inform als vollständige URL, in das Override-Feld dagegen nur als Host. Betreibst du deinen UniFi Controller bei clevendo und kommst bei Adoption oder Umzug nicht weiter, findest du die passenden Anleitungen in unserem clevendo-Hilfebereich.
Häufige Fragen
Was macht der Befehl set-inform?
Er teilt einem UniFi-Gerät per SSH mit, unter welcher Adresse die Network-Anwendung erreichbar ist. Das Format lautet set-inform http://<ip-oder-fqdn>:8080/inform. Danach erscheint das Gerät im Site Manager oder in der UniFi Mobile App zur Adoption.
Muss ich set-inform zweimal ausführen?
Manchmal ja. Ubiquiti weist darauf hin, dass du den Befehl eventuell wiederholen musst, nachdem das Gerät in UniFi aufgetaucht ist. Klappt die Übernahme nicht auf Anhieb, setze ihn mit derselben URL erneut ab.
Was trage ich bei Override Inform Host ein?
Nur die Adresse des neuen Hosts, keine vollständige Inform-URL. Ubiquiti nennt die IP-Adresse des neuen Hosts; beim Umzug zu Official UniFi Hosting nimmst du die Inform-URL aus dem Dashboard und entfernst http:// sowie :8080/inform. Der Schalter wird in der alten Network-Anwendung aktiviert, nicht in der neuen.
Welcher Port muss für die Inform-Kommunikation offen sein?
TCP-Port 8080. Gerät und Network-Anwendung müssen darüber uneingeschränkt kommunizieren können – durch alle Gateways, Firewalls und Antiviren-Programme hindurch. Für die Discovery im lokalen Netz nennt Ubiquiti zusätzlich UDP-Port 10001.