UniFi Troubleshooting – Lösungen für Administratoren

UniFi Troubleshooting bedeutet, Fehler in einem UniFi Netzwerk systematisch einzugrenzen: Erreicht das Gerät den Controller? Stimmen VLAN, Firewall-Regel und DNS? Läuft auf allen Geräten eine passende Firmware? Auf dieser Seite haben die zertifizierten UniFi Engineers der InSys AG^® die Probleme zusammengestellt, die Administratoren in Unternehmensnetzen am häufigsten lösen müssen – jeweils mit Symptom, Ursache und Lösungsweg.

Die Kapitel folgen der Reihenfolge, in der Fehler typischerweise auftreten: Geräte einbinden, Zugangsdaten und Reset, VPN, Firewall und Ports, DNS, VLAN und Switching, WLAN, Updates und zum Schluss die wichtigsten Fehlermeldungen im Wortlaut. Menünamen und Standardwerte beziehen sich auf UniFi Network ab Version 9 und UniFi OS ab Version 4 (Stand Oktober 2026). In älteren Versionen können Bezeichnungen abweichen.

Ausführliche Anleitungen zu einzelnen Themen finden Sie in unseren Leitfäden zu 802.1X mit Cisco ISE, MC-LAG und zum UniFi Site Manager mit Fabrics.

Symptom: Ein Access Point oder Switch erscheint nicht in UniFi Network, bleibt im Status „Adopting“ hängen oder meldet „Adoption Failed“.

Ursache: UniFi Geräte finden ihren Controller automatisch per Broadcast – aber nur im selben Layer-2-Netz. Liegt das Gerät in einem anderen VLAN, an einem anderen Standort oder hinter einer Firewall, kennt es die Adresse des Controllers nicht. Weitere häufige Ursachen: Das Gerät ist noch einem anderen Controller zugeordnet, die Firmware ist sehr alt, oder der Port TCP 8080 ist gesperrt.

Lösungsweg:

1. Erreichbarkeit prüfen: Das Gerät muss den Controller über TCP 8080 (Inform) und UDP 3478 (STUN) erreichen. Prüfen Sie Routing und Firewall-Regeln zwischen Geräte-VLAN und Controller.
2. Inform-Adresse per SSH setzen: Per SSH auf das Gerät verbinden und set-inform <IP-des-Controllers>/inform eingeben. Danach das Gerät in UniFi Network adoptieren. Bleibt es hängen, den Befehl nach der Adoption ein zweites Mal ausführen.
3. Dauerhaft für Außenstandorte: Statt jedes Gerät einzeln umzustellen, verteilen Sie die Controller-Adresse per DHCP-Option 43 oder über einen DNS-Eintrag „unifi“. Bei Controllern hinter NAT tragen Sie in UniFi Network unter Inform Host Override den öffentlichen Namen oder die IP ein.
4. Fremd verwaltete Geräte: Zeigt UniFi Network „Managed by Other“, gehört das Gerät noch einem anderen Controller. Entfernen Sie es dort oder setzen Sie es auf Werkseinstellungen zurück (siehe nächstes Kapitel).

Bei neuen Standorten sparen Sie sich diese Schritte ganz: Mit Zero-Touch-Provisioning im UniFi Site Manager treten Geräte automatisch dem richtigen Standort bei. Welcher Controller für Ihre Umgebung passt, zeigt unser Vergleich Was macht der UniFi Controller?

Symptom: Ein Gerät lässt sich nicht mehr verwalten, der SSH-Login schlägt fehl, oder ein gebrauchtes Gerät soll in ein neues Netz.

• Werksreset per Taste: Bei eingeschaltetem Gerät die Reset-Taste etwa 10 Sekunden gedrückt halten, bis die Status-LED das Verhalten ändert. Danach startet das Gerät neu und ist wieder bereit zur Adoption. Die genaue Dauer und das LED-Muster unterscheiden sich je nach Modell.
• Werksreset per SSH: Ist das Gerät schwer zugänglich, etwa ein Access Point an der Decke, setzen Sie es per SSH mit set-default zurück.
• SSH-Zugangsdaten adoptierter Geräte: Nach der Adoption gelten nicht mehr die Werks-Zugangsdaten, sondern die in UniFi Network hinterlegten Device-SSH-Zugangsdaten. Sie finden sie in den erweiterten Systemeinstellungen. Ist SSH dort deaktiviert, ist auch kein Login möglich.
• Werks-Zugangsdaten: Nicht adoptierte Geräte akzeptieren je nach Modell und Firmware ubnt/ubnt oder ui/ui. Ändern Sie diese Werte nach der Inbetriebnahme sofort.
• Konsolen und Cloud Keys: Die Konsole selbst (Cloud Gateway, Cloud Key, NVR) verwaltet ihre Zugangsdaten in UniFi OS. Ein Werksreset löscht hier die gesamte Konfiguration aller Anwendungen – erstellen Sie vorher ein Backup.

Wichtig für Unternehmen: Ein Reset löst das Problem, aber nicht die Ursache. Häufen sich verwaiste Geräte oder unbekannte Zugangsdaten, fehlt meist eine saubere Dokumentation. Diese Aufgabe übernimmt unser UniFi Managed Service.

Symptom: Der VPN-Tunnel baut sich nicht auf, steht zwar, überträgt aber keine Daten, oder Mitarbeitende erreichen von unterwegs nur einen Teil der Systeme.

Welches VPN für welchen Zweck:

• Standorte untereinander (Site-to-Site): Zwischen UniFi Gateways ist Site Magic SD-WAN der einfachste Weg – die Tunnel entstehen automatisch über den Site Manager. Zu Firewalls anderer Hersteller verbinden Sie per IPsec.
• Mitarbeitende unterwegs: WireGuard ist schnell und stabil, OpenVPN als Alternative verfügbar. Teleport baut per App mit einem Klick einen WireGuard-Tunnel auf. Im Unternehmen ist die zentrale Verteilung über UniFi Endpoint mit Microsoft Entra ID meist die bessere Wahl.
• Hotel und Geschäftsreise: Der UniFi Travel Router baut das Firmen-WLAN samt VPN unterwegs auf.

Die häufigsten Ursachen und Lösungen:

1. Überlappende Netze: Nutzen zwei Standorte oder das Heimnetz der Mitarbeitenden denselben Adressbereich (zum Beispiel 192.168.1.0/24), findet der Datenverkehr nicht zurück. Planen Sie für jeden Standort eigene, eindeutige Netze.
2. Kein öffentlicher Zugang: Steht das Gateway hinter einem Provider-Router oder in einem Carrier-Grade-NAT, kommen eingehende VPN-Verbindungen nicht an. Lösung: Bridge-Modus am Router oder Portweiterleitung für den VPN-Port (bei WireGuard standardmäßig UDP 51820). Wie das bei einer Fritzbox geht, zeigt unsere Anleitung Fritzbox Bridge Mode mit UniFi Gateway.
3. Tunnel steht, aber kein Zugriff: Meist blockiert die Firewall den Verkehr aus der VPN-Zone in die internen Netze, oder die Clients erhalten keinen internen DNS-Server.

Symptom: Ein Dienst ist von außen nicht erreichbar, Geräte verlieren die Verbindung zum Controller, oder Netze sind stärker oder schwächer getrennt als geplant.

Zone-Based Firewall verstehen: Seit UniFi Network 9 ordnen Sie Netze Zonen zu, etwa Internal, External, Gateway, VPN, Hotspot und DMZ. Regeln gelten zwischen Zonen. Wichtig: Netze in derselben Zone dürfen standardmäßig miteinander kommunizieren. Wer Gäste-, IoT- oder Kameranetze trennen will, legt dazu eigene Zonen oder gezielte Block-Regeln an.

Ports, die UniFi selbst braucht:

• TCP 8080: Inform – Geräte melden sich beim Controller
• UDP 3478: STUN – Kommunikation zwischen Controller und Geräten
• UDP 10001: Geräteerkennung im lokalen Netz
• TCP 443 bzw. 8443: Weboberfläche der UniFi Konsole bzw. einer selbst betriebenen UniFi Network Application

Port Forwarding: Portweiterleitungen legen Sie in UniFi Network an. Sie greifen nur, wenn das UniFi Gateway selbst die öffentliche IP-Adresse hat. Steht davor ein Provider-Router, muss auch dort weitergeleitet werden – oder Sie vermeiden das doppelte NAT ganz. Am Glasfaseranschluss geht das am saubersten mit dem Gateway direkt am Glasfasermodem, siehe Glasfaser-Router mit UniFi Cloud Gateway.

Prüfen Sie freigegebene Ports regelmäßig: Jede Weiterleitung ist ein Einfallstor. Sicherer ist es, interne Dienste über VPN zu erreichen. Wo SSL/TLS-Inspection und eine Firewall auf Enterprise-Niveau gefragt sind, setzen wir die UniFi Enterprise Firewall ein.

Symptom: Interne Server sind nur per IP-Adresse erreichbar, die Anmeldung an der Windows-Domäne schlägt fehl, oder Drucker und AirPlay-Geräte sind aus einem anderen VLAN nicht sichtbar.

• DNS in Active-Directory-Umgebungen: Standardmäßig verteilt der DHCP-Server des UniFi Gateways sich selbst als DNS-Server. In Domänennetzen tragen Sie in den DHCP-Einstellungen des jeweiligen Netzes stattdessen die Domänencontroller ein. Sonst finden die Clients die Domäne nicht.
• Lokale DNS-Einträge: Für einzelne interne Namen ohne eigenen DNS-Server legen Sie lokale DNS-Einträge direkt im UniFi Gateway an. Für eine ganze Domäne bleibt ein richtiger DNS-Server die bessere Lösung.
• mDNS über VLAN-Grenzen: Bonjour, AirPlay und viele Drucker finden sich per Multicast DNS nur im eigenen Netz. Aktivieren Sie in UniFi Network Multicast DNS gezielt für die Netze, die sich sehen sollen – nicht pauschal für alle.
• Verschlüsseltes DNS und Inhaltsfilter: UniFi Gateways unterstützen verschlüsseltes DNS und Inhaltsfilterung. Beides wirkt nur, wenn Clients tatsächlich den Gateway-DNS nutzen.

An mehreren Standorten setzen Sie solche Einstellungen mit Canvas im UniFi Site Manager einheitlich durch.

Symptom: Geräte in einem VLAN bekommen keine IP-Adresse, Access Points verlieren nach einer Änderung am Switch-Port die Verbindung, oder es entstehen kurzzeitig Netzwerkschleifen.

• VLANs anlegen und zuweisen: Jedes Netz bekommt in UniFi Network eine eindeutige VLAN-ID. Auf den Switch-Ports legen Sie im Port Manager fest, welches Netz untagged (Native VLAN) und welche Netze tagged anliegen. Access Points brauchen auf ihrem Port alle VLANs der SSIDs, die sie ausstrahlen.
• Management-VLAN nicht abschneiden: Der häufigste Fehler beim Umbau: Das Native VLAN eines Uplinks wird geändert, und nachgelagerte Switches oder Access Points erreichen den Controller nicht mehr. Ändern Sie Uplinks immer von außen nach innen und prüfen Sie nach jedem Schritt die Erreichbarkeit.
• Link Aggregation (LACP): Bündeln Sie Ports im Port Manager. Beide Seiten müssen LACP mit denselben Ports und VLANs sprechen. Für Ausfallsicherheit über zwei Switches hinweg ist MC-LAG der richtige Weg.
• Spanning Tree (STP): UniFi Switches nutzen standardmäßig RSTP. Setzen Sie die STP-Priorität des Core-Switches niedriger als bei allen anderen Switches, zum Beispiel auf 4096. Dann wird er sicher Root Bridge, und der Datenverkehr nimmt nach einer Schleife nicht den Umweg über einen Etagenswitch.
• 802.1X und RADIUS: UniFi Gateways bringen einen eigenen RADIUS-Server mit. In größeren Umgebungen binden Sie Switches und Access Points an einen zentralen RADIUS an, zum Beispiel Microsoft NPS oder Cisco ISE. Wie das geht, zeigt unser Leitfaden UniFi 802.1X mit Cisco ISE.

Welche Switches für Core und Etagenverteiler passen, finden Sie bei unseren UniFi Enterprise Switches.

Symptom: Laptops bleiben an einem weit entfernten Access Point hängen, Telefonate brechen beim Gang durchs Gebäude ab, oder das WLAN ist trotz voller Balken langsam.

• Sendeleistung und Kanalbreite: In Büros mit vielen Access Points ist „mehr“ selten besser. Reduzieren Sie die Sendeleistung, nutzen Sie im 5-GHz-Band 40 oder 80 MHz statt 160 MHz und im 2,4-GHz-Band ausschließlich 20 MHz. So stören sich benachbarte Access Points weniger.
• Roaming: Fast Roaming (802.11r) und BSS Transition (802.11v) helfen Clients, rechtzeitig zum besseren Access Point zu wechseln. Ältere Geräte wie Scanner oder Drucker vertragen 802.11r teilweise nicht – betreiben Sie solche Geräte bei Problemen in einer eigenen SSID ohne Fast Roaming.
• Kanalplanung: Die automatische Kanaloptimierung von UniFi funktioniert gut, wenn die Access Points richtig platziert sind. Ist die Ausleuchtung falsch geplant, hilft auch keine Optimierung.
• Mesh nur als Ausnahme: Access Points per Funk anzubinden halbiert die verfügbare Bandbreite. Im Unternehmen gehört jeder Access Point an ein Kabel mit PoE.

Die meisten WLAN-Probleme entstehen schon bei der Planung. Mit der UniFi WLAN-Planung simulieren wir die Ausleuchtung vorab im UniFi Design Center. Die passenden Modelle finden Sie bei den UniFi WiFi 7 Access Points.

Symptom: Nach einem Update verhalten sich Geräte anders, einzelne Access Points sind offline, oder Funktionen fehlen plötzlich.

1. Release-Kanal festlegen: Für produktive Netze nur offizielle Versionen verwenden, keine Early-Access- oder Release-Candidate-Versionen.
2. Backup vor jedem Update: Erstellen Sie vor jedem Update ein Backup der Konsole und laden Sie es herunter. Automatische Backups helfen nur, wenn sie außerhalb der Konsole liegen.
3. Reihenfolge einhalten: Zuerst UniFi OS und die UniFi Network Anwendung aktualisieren, danach die Geräte – und dort von außen nach innen: Access Points, dann Access-Switches, zuletzt Core-Switches und Gateway.
4. Updates zeitlich steuern: Automatische Geräte-Updates legen Sie in ein Wartungsfenster außerhalb der Geschäftszeiten. Bei vielen Standorten erst einen Pilotstandort aktualisieren, dann die übrigen.
5. Release Notes lesen: Ubiquiti ändert mit größeren Versionen gelegentlich Menüs und Standardwerte, zuletzt etwa mit der Umstellung auf die Zone-Based Firewall. Prüfen Sie vor dem Update, was sich für Ihre Konfiguration ändert.

Im UniFi Managed Service prüfen wir neue Versionen, bevor wir sie bei unseren Kunden einspielen.

UniFi zeigt Fehlermeldungen auch in deutschen Oberflächen oft auf Englisch. Hier die häufigsten Meldungen mit ihrer Bedeutung und dem ersten Schritt zur Lösung.

„Adoption Failed“ oder „There was an error adopting“

Das Gerät hat den Controller zwar gefunden, konnte die Verbindung aber nicht dauerhaft aufbauen. Prüfen Sie, ob das Gerät den Controller über TCP 8080 und UDP 3478 erreicht, und setzen Sie die Inform-Adresse per set-inform erneut.

„Managed by Other“

Das Gerät ist noch einem anderen Controller zugeordnet. Entfernen Sie es dort über „Forget“ oder setzen Sie es auf Werkseinstellungen zurück.

„Disconnected“ oder „Offline“

Der Controller hat länger keine Meldung des Geräts erhalten. Häufige Ursachen sind ein fehlendes Management-VLAN am Switch-Port, ein nicht ausreichendes PoE-Budget oder eine Firewall-Regel, die den Inform-Port blockiert.

„Rogue Access Point Detected“

Ihre Access Points haben einen fremden Access Point erkannt. Das kann ein harmloses Nachbarnetz sein, aber auch ein privater Router im Firmennetz oder ein Angreifer, der Ihre SSID nachahmt. Prüfen Sie, ob der gemeldete Access Point die eigene SSID ausstrahlt oder an Ihrem Netz hängt.

„Database was not running“

Diese Meldung betrifft selbst betriebene Installationen der UniFi Network Application. Die interne Datenbank ist nicht gestartet, häufig weil die Festplatte voll ist oder ein Update unterbrochen wurde. Prüfen Sie den freien Speicherplatz und spielen Sie im Zweifel das letzte Backup auf einer frischen Installation ein. Dauerhaft vermeiden Sie das Problem mit einem Cloud Gateway oder dem UniFi OS Server statt einer selbst gepflegten Installation.

Ubiquiti selbst bietet keinen telefonischen Support. Hilfe gibt es über die Ubiquiti Community, die Online-Dokumentation und den Chat. Für Unternehmen, die mehr brauchen, gibt es drei Wege zur InSys AG^®:

• Bestandskunden: Geschäftskunden der InSys AG^® eröffnen ein Ticket per E-Mail an support@insys.de. Unsere Systeme nehmen dabei ausschließlich Anfragen von den Unternehmensdomänen unserer Kunden an (Whitelist). Anfragen von privaten oder kostenlosen E-Mail-Adressen werden nicht angenommen. Einen telefonischen Support bieten wir bewusst nicht an: Ein Ticket dokumentiert das Problem vollständig und landet direkt bei einem zertifizierten Engineer.
• Dauerhafte Betreuung: Mit dem UniFi Managed Service überwachen wir Ihr Netzwerk, spielen geprüfte Updates ein und lösen Probleme, bevor Ihre Mitarbeitenden sie bemerken.
• Einzelne Projekte und Fragen: Im UniFi Consulting helfen wir bei Planung, Migration oder einem konkreten Problem, das Sie intern nicht lösen können.

Sie suchen einen UniFi Dienstleister für Ihr Unternehmen? Als Ubiquiti Enterprise Partner und UniFi Professional Integrator betreut die InSys AG^® UniFi Netzwerke in ganz Deutschland und Europa. Wir arbeiten ausschließlich für Geschäftskunden.

Sie möchten Ihr UniFi Netzwerk nicht mehr selbst betreuen oder brauchen Unterstützung bei einem größeren Umbau? Schildern Sie uns kurz Ihre Umgebung im folgenden Kontaktformular – zum Beispiel wie viele Standorte, Switches und Access Points Sie betreiben und wobei Sie Unterstützung suchen. Unsere zertifizierten UniFi Consultants melden sich innerhalb eines Werktages.

Lieber direkt sprechen? Rufen Sie uns an unter +49 (521) 260105-0. Bestandskunden mit einem konkreten Störungsfall nutzen bitte den Ticket-Weg über support@insys.de.