BrillianzeHomelab
Vergleich
BsN-Ochsenkopf in Schwarz-Rot-Gold mit goldenem C

Home Assistant, MQTT und Mosquitto: Zuständigkeiten klären

Ein MQTT-Gerät spricht nicht direkt mit dem Home-Assistant-Dashboard. Es veröffentlicht Nachrichten bei einem Broker; Home Assistant verbindet sich über seine MQTT-Integration mit diesem Broker und wertet passende Themen aus. Die Integrationsdokumentation unterscheidet ausdrücklich zwischen Broker-Einrichtung und MQTT-Konfiguration in Home Assistant.[1] Mosquitto ist eine mögliche Broker-Implementierung. Dieser Artikel behandelt die Verbindung und ihre Fehlerbilder, nicht die allgemeine Smart-Home-Installation.

Broker-App oder eigener Dienst?

Für eine Home-Assistant-Installation mit App-Verwaltung dokumentiert das Projekt eine Mosquitto-Broker-App: Installation über „Einstellungen → Apps“, Start und Prüfung des App-Logs. Danach kann die entdeckte MQTT-Integration im Bereich „Geräte & Dienste“ eingerichtet werden.[2] Das verkürzt die Kopplung, bindet den Broker aber enger an diesen Home-Assistant-Host. Ein selbst verwalteter Mosquitto auf einem anderen System ist möglich; dann musst du Erreichbarkeit, Zugangsdaten und Wartung für beide Dienste gesondert organisieren.[1]

Die Entscheidung hängt weniger von der Zahl der Schalter als vom gewünschten Ausfallverhalten ab: Sollen MQTT-Geräte auch bei einer Home-Assistant-Wartung denselben unabhängigen Broker verwenden? Dann kann ein separater Dienst sinnvoll sein. Ist möglichst wenig eigene Infrastruktur das Ziel und deine Installation unterstützt Apps, ist die offizielle Broker-App der naheliegende Einstieg. Beides ist eine Betriebsentscheidung, keine universell schnellere Lösung.

Anmeldung, Themen und Discovery

Die Broker-App empfiehlt einen eigenen MQTT-Nutzer über die Home-Assistant-Benutzerverwaltung. Ihre Dokumentation erklärt außerdem, dass diese App keine anonymen Logins unterstützt; die Namen homeassistant und addons sind intern reserviert.[2] Verwende für Geräte keine Administrator-Zugangsdaten, wo ein eigener Benutzer genügt. Für einen eigenständig betriebenen Mosquitto beschreibt die Konfigurationsreferenz Passwortdateien und Zugriffsregeln; sie warnt, dass Benutzername und Passwort ohne Transportverschlüsselung abgefangen werden können.[3]

MQTT-Discovery ermöglicht die automatische Anlage unterstützter Entitäten, ist aber kein Beweis, dass Sensordaten richtig oder aktuell sind. Laut Home-Assistant-Dokumentation existieren zudem Birth- und Last-Will-Nachrichten, Discovery-Konfigurationen und Availability-Themen als verschiedene Mechanismen.[1] Trenne daher „Gerät angelegt“, „Gerät erreichbar“ und „Messwert ändert sich“ bei der Fehlersuche. Retained Discovery-Nachrichten und Zustandsmeldungen können sich anders verhalten als spontane Nachrichten; prüfe konkret, was dein Gerät tatsächlich veröffentlicht.

Prüfschritte vom Transport bis zur Entität

Prüfe zuerst Broker-Log und Status, dann die Verbindung der MQTT-Integration einschließlich Hostname und Benutzer. Nutze anschließend die in der Home-Assistant-Dokumentation beschriebene Möglichkeit, auf ein Thema zu lauschen, und beobachte beim Auslösen eines Geräts die tatsächlich eintreffende Nachricht.[1] Bleibt sie aus, prüfe Geräteverbindung und Topic-Berechtigung; kommt sie an, aber keine Entität reagiert, prüfe Discovery-Nachricht beziehungsweise manuelle Entitätskonfiguration.

Für einen Broker außerhalb des geschützten lokalen Segments sind TLS und passende Zertifikatsprüfung wichtig: Home Assistant beschreibt die Validierung des Broker-Zertifikats und die Möglichkeit, eine eigene CA einzubinden.[1] Deaktiviere Zertifikatsprüfung nicht bloß, um eine Fehlermeldung zu umgehen. Teste nach einem geplanten Broker-Neustart, ob Geräte sich erneut verbinden und ob Availability und Zustände sinnvoll erscheinen. Prüfe dabei auch, ob die ersten Nachrichten nach dem Wiederverbinden aktuelle Werte enthalten oder nur einen zuvor gespeicherten Zustand wiedergeben. Ein sichtbares Gerät im Dashboard allein belegt noch keine stabile Nachrichtenkette.

Quellen

  1. Home Assistant: MQTT-Integration
  2. Home Assistant: Mosquitto-Broker-App
  3. Eclipse Mosquitto: Konfigurationsreferenz