Zigbee2MQTT: Adapter disconnected / Failed to start Zigbee2MQTT
Zigbee2MQTT bekommt keinen stabilen Zugriff auf den Zigbee-Adapter oder das Funknetz.
Kurz gesagt
Typische Ursachen sind falscher Adapterpfad, TCP-/Seriell-Verbindung, belegter Port oder Adapter-/Firmwareproblem.
Ändere nicht mehrere Dinge gleichzeitig. Mit den folgenden Schritten lässt sich die Ursache meist deutlich eingrenzen, ohne die bestehende Installation unnötig auseinanderzunehmen.
So gehst du jetzt vor
- Adapterpfad bzw. TCP-Adresse prüfen.
- Sicherstellen, dass kein zweiter Dienst denselben Port nutzt.
- Die ersten Adapterzeilen im Startlog prüfen.
- Bei LAN-Coordinatoren Netzwerk und Strom/PoE kontrollieren.
Warum die Meldung auftaucht
Typische Ursachen sind falscher Adapterpfad, TCP-/Seriell-Verbindung, belegter Port oder Adapter-/Firmwareproblem.
Wichtig ist der Zusammenhang: Zeitpunkt, betroffene Komponente und die Zeilen unmittelbar vor bzw. nach der Meldung. Ein einzelner Logsatz reicht nicht immer für eine eindeutige Diagnose.
Was du besser nicht sofort machst
Kein Werksreset, kein Löschen der Integration, kein Datenbank-Löschen und keine komplette Neuinstallation nur aufgrund dieser einen Meldung. Sichere vorher die Ausgangslage und arbeite den kleinsten sinnvollen Prüfschritt ab.
Häufige Fragen
Ist dieser Fehler kritisch?
Ja – besonders dann, wenn die Meldung regelmäßig wiederkehrt oder die betroffene Funktion tatsächlich ausfällt.
Muss ich neu installieren oder das Gerät löschen?
In der Regel nein. Zuerst Ursache, Erreichbarkeit und konkrete Konfiguration prüfen. Neuinstallation oder Löschen ist ein später Schritt, nicht der erste.
Kann ich den kompletten Log in den WATTZAHLS Fehler-Check werfen?
Ja, aber am besten nur den relevanten zusammenhängenden Block. Der Fehler-Check schwärzt typische sensible Werte vor der Analyse; Zugangsdaten und Tokens solltest du trotzdem nie bewusst mitsenden.
Passend dazu
Weiterführende Dokumentation: Zigbee2MQTT Dokumentation ↗