MQTT einrichten: vom Broker zum nutzbaren Sensor.

1. Zuerst den benötigten Datenweg festlegen

Klären Sie, welchen Wert oder welche Funktion Sie benötigen. Ein vorhandener Sensor kann beispielsweise Temperaturmeldungen veröffentlichen, während Home Assistant sie für Verlauf und Benachrichtigungen verwendet. MQTT legt den Nachrichtentransport fest, aber nicht automatisch die Bedeutung jeder Nachricht. Die Gerätedokumentation muss Themenpfade, Datenformat und unterstützte Aktionen beschreiben.

Prüfen Sie vorab auch eine vorhandene direkte Integration. Für die offizielle Shelly-Anbindung oder die native ESPHome-API ist ein zusätzlicher MQTT-Broker nicht grundsätzlich erforderlich. MQTT lohnt sich, wenn die konkrete Geräteschnittstelle oder der geplante Datenaustausch dafür spricht.

2. Einen passenden lokalen Broker auswählen

Der Broker verteilt Nachrichten zwischen angemeldeten Teilnehmern. Unter Home Assistant OS ist die offizielle Mosquitto-Broker-App ein vorgesehener Weg; alternativ kann ein separat verwalteter kompatibler Broker verwendet werden. Für Ihr Zuhause planen wir einen eigenen Broker und keinen öffentlich zugänglichen Testdienst als dauerhafte Infrastruktur.

Die aktuelle Home-Assistant-Dokumentation verlangt MQTT-Version 5 beim Broker. Mosquitto unterstützt MQTT 5.0, 3.1.1 und 3.1. Daraus folgt keine pauschale MQTT-5-Pflicht für jeden Sensor: Dessen Verbindung wird zusätzlich nach Geräteprotokoll und Brokerkonfiguration geprüft. Ein alter Geräteclient ist nicht allein wegen seiner Versionsnummer ausgeschlossen.

3. Adresse, Transport und Zugänge abstimmen

Notieren Sie Broker-Adresse, tatsächlich eingerichteten Port und Transport. In der offiziellen Mosquitto-App ist TCP-Port 1883 standardmäßig unverschlüsselt; 8883 bietet bei eingerichtetem Zertifikat TLS. WebSockets sind eine separate Option. Benutzername und Passwort allein machen eine unverschlüsselte Verbindung nicht vertraulich.

Die App unterstützt keine anonymen Anmeldungen. Zusätzliche Gerätezugänge können eingerichtet werden. Wir empfehlen nachvollziehbar zugeordnete Zugangsdaten statt eines gemeinsam herumgereichten Administratorkontos. Getrennte Logins ersetzen allerdings keine Prüfung der erlaubten Themenpfade. Für TLS müssen Zertifikat, Hostname und Vertrauen zusammenpassen; Zertifikatsprüfungen werden nicht einfach dauerhaft abgeschaltet.

4. Home Assistant und ein Testgerät verbinden

Fügen Sie unter Einstellungen, Geräte und Dienste die MQTT-Integration hinzu und folgen Sie dem Dialog für den gewählten Broker. Bei der offiziellen App kann Home Assistant die Verbindung passend vorbereiten. Tragen Sie am Endgerät dessen eigenen Brokerzugang ein und prüfen Sie anschließend die Verbindungsanzeige oder das Protokoll.

Beginnen Sie mit einem Gerät und einem ungefährlichen Messwert. Halten Sie fest, welches Gerät sich verbindet und welcher Themenpfad seine Daten trägt. Ein erfolgreich angemeldeter Client beweist noch nicht, dass Home Assistant den Inhalt als Temperatur, Leistung oder Schaltzustand versteht. Neue Internet-Portfreigaben sind für diesen lokalen Aufbau nicht nötig.

5. Discovery und Zustandsdaten unterscheiden

Discovery beschreibt Home Assistant, welche Entität angelegt werden soll und wo deren Werte stehen. Eine beliebige veröffentlichte Zahl erzeugt daher nicht automatisch eine passende Kachel. Das Gerät muss Home-Assistant-Discovery unterstützen oder seine Entitäten werden anhand der dokumentierten Schnittstelle gezielt konfiguriert.

6. Gespeicherte Nachrichten richtig einordnen

Eine als „retained“ veröffentlichte Nachricht bleibt beim Broker für spätere Abonnenten verfügbar. Das kann beim Wiederanlauf hilfreich sein. Ein sofort angezeigter Wert kann deshalb jedoch die letzte bekannte Meldung sein und muss keine neue Messung darstellen. Datenalter und Verfügbarkeit gehören gemeinsam in die Prüfung.

Bei ESPHome ist das Beibehalten von MQTT-Discovery-Nachrichten dokumentiert. Nach Umbenennungen können dadurch alte Entitäten wieder auftauchen. Löschen Sie nicht pauschal den gesamten Brokerbestand: Ordnen Sie zuerst die veraltete Konfiguration dem richtigen Gerät zu. Befehle und Messwerte dürfen beim Umgang mit gespeicherten Nachrichten nicht verwechselt werden.

7. Normalbetrieb und Wiederanlauf testen

Prüfen Sie beim Testgerät einen nachvollziehbaren Wertwechsel und die Anzeige in Home Assistant. Planen Sie danach eine kurze Unterbrechung nur für diesen unkritischen Testteilnehmer. Beobachten Sie, ob er als nicht verfügbar erkannt wird und nach seiner Rückkehr wieder aktuelle Werte liefert. Ein bestandener Verbindungstest ersetzt diesen Funktionsvergleich nicht. Im Konfigurationsdialog der MQTT-Integration können Sie den bekannten Zustands-Themenpfad mit „Listen to a topic“ beobachten. Dieser reine Lesetest hilft beim Vergleich; veröffentlichen Sie dabei keine Befehle an reale Aktoren.

Testen Sie einen Broker-Neustart erst zu einem vereinbarten Zeitpunkt: Alle darüber verbundenen Geräte sind betroffen. Prüfen Sie danach Wiederverbindung, Entitätszuordnung und erste neue Meldungen. Halten Sie Fehler getrennt fest: Anmeldung fehlgeschlagen, keine Discovery, falscher Wert oder fehlende Verfügbarkeitsmeldung.

8. Konfiguration und Verantwortung sichern

Dokumentieren Sie Broker-Version, Speicherort, zusätzliche Logins, Zertifikate, individuelle Einstellungen und die zugehörigen Geräte. Die MQTT-Dokumentation weist bei einer Neuinstallation der offiziellen App ausdrücklich auf das Sichern zusätzlicher Benutzeroptionen hin. Ein extern betriebener Broker ist nicht automatisch durch eine Home-Assistant-Sicherung abgedeckt.

Prüfen Sie, welche Brokerdaten und Konfigurationen Ihre Sicherung tatsächlich enthält. Zugangsdaten werden vertraulich aufbewahrt und bei der Übergabe gezielt zugänglich gemacht. Wer Updates durchführt und Störungen bearbeitet, sollte feststehen. Elektro-Zentrum unterstützt bei Auswahl, Einrichtung und dokumentierter Prüfung des geeigneten Aufbaus; Umfang und notwendige Ergänzungen werden vorab vereinbart.

Themenpfade so planen, dass mehrere Geräte verständlich bleiben

Für einen kleinen Test reicht es zunächst, einen bekannten Messwert zu beobachten. In einer dauerhaft genutzten Installation sollte jedoch nachvollziehbar bleiben, welches Gerät welche Nachrichten liefert und welche Funktion diese Nachrichten haben. Zustandsdaten, Verfügbarkeit und mögliche Befehle werden deshalb bewusst unterschieden. Eine eindeutige Zuordnung erleichtert spätere Änderungen und verhindert, dass ein ähnlicher Name versehentlich für eine andere Aufgabe verwendet wird. Dabei orientieren wir uns an den dokumentierten Möglichkeiten der beteiligten Geräte, statt deren erwartete Themenpfade beliebig umzubenennen.

Für die Übergabe ist eine kurze Liste der Geräte, Aufgaben und Verbindungen hilfreich. Darin kann beispielsweise stehen, welcher Sensor einen Raumwert liefert und welche Anzeige ihn verwendet. Vertrauliche Kennwörter gehören nicht in eine frei weitergegebene Geräteliste. Zugangsdaten und technische Zuordnung werden getrennt aufbewahrt. Wenn später ein Gerät ersetzt wird, ist dadurch erkennbar, welche Anzeigen und Regeln betroffen sind. Eine neue erfolgreiche Anmeldung am Broker reicht dann noch nicht als Abschluss: Die neue Datenquelle muss auch die vereinbarte Bedeutung, Aktualität und Verfügbarkeit liefern.

Fehler nach ihrer Ebene eingrenzen

Eine Störung kann vor der Anmeldung, beim Nachrichtenaustausch oder erst bei der Auswertung in Home Assistant entstehen. Die Fehlersuche wird deshalb in nachvollziehbare Fragen aufgeteilt. Ist der Broker erreichbar? Meldet sich der erwartete Teilnehmer an? Erscheint der dokumentierte Wert am richtigen Themenpfad? Ist die Entität passend beschrieben und wird sie tatsächlich aktualisiert? Diese Reihenfolge hilft, einen fehlenden Sensor von einem bloßen Anzeigeproblem zu unterscheiden. Sie vermeidet außerdem, gleichzeitig mehrere funktionierende Teile ohne klaren Anlass zu verändern.

Beobachtungen werden mit Zeitpunkt und betroffenem Gerät festgehalten. Ein alter retained Wert kann unmittelbar nach einem Neustart plausibel aussehen, obwohl noch keine neue Messung eingetroffen ist. Umgekehrt muss ein kurzzeitig fehlender Wert nicht bedeuten, dass die gesamte Brokerinstallation neu aufgebaut werden sollte. Der konkrete Verlauf ist entscheidend. Für einen Serviceauftrag reichen zunächst eine Beschreibung der Abweichung und die bekannten beteiligten Geräte. Vollständige Protokolle können Zugangsdaten oder andere vertrauliche Angaben enthalten und werden daher erst nach Abstimmung in geeigneter Form bereitgestellt.

Einen Broker als gemeinsam genutzte Infrastruktur betreuen

Ein Broker kann mehrere unterschiedliche Geräte verbinden. Wartung, Neustart oder geänderte Zugangsdaten wirken dann unter Umständen auf mehr als die gerade betrachtete Anzeige. Vor einem Eingriff wird deshalb geklärt, welche weiteren Funktionen dieselbe Instanz verwenden. Für einen überschaubaren Test eignet sich ein unkritischer Messwert; ein produktiver Neustart wird zu einem vereinbarten Zeitpunkt durchgeführt. Die anschließende Prüfung betrachtet die wichtigen Teilnehmer und deren neue Meldungen, nicht nur den gestarteten Brokerprozess.

Bei einer getrennt betriebenen Brokerinstallation müssen Sicherung und Zuständigkeit ebenfalls getrennt benannt werden. Ein Backup der Home-Assistant-Oberfläche umfasst nicht automatisch sämtliche externen Einstellungen. Wir erfassen, wo Konfiguration, benötigte Zugangsinformationen und gegebenenfalls Zertifikate verwahrt werden. Die gewünschte Betreuung wird ausdrücklich vereinbart. Ein einmaliger Einrichtungsauftrag enthält keine dauerhafte Beobachtung aller Nachrichten und keine pauschale Fehlerbehebung nach späteren Geräte- oder Softwareänderungen. Mit dieser Abgrenzung bleibt MQTT eine nachvollziehbare Schnittstelle statt einer zusätzlichen Infrastruktur, deren Aufgaben niemand mehr zuordnen kann.

Einrichtung, Hardware und Vor-Ort-Leistung getrennt beauftragen

Die aktuelle Preisübersicht trennt Einrichtung per vereinbartem Fernzugriff von zusätzlicher Hardware und Arbeiten vor Ort. Für einen Softwareauftrag müssen geeignete Geräte, notwendige Unterlagen und ein nutzbarer Zugang vorbereitet sein. Physischer Aufbau, elektrische Montage, zusätzliche Leitungen oder ein ungeklärtes Netzwerkproblem sind nicht automatisch Bestandteil eines Remote-Pakets. Wir beschreiben den konkreten Ausgangszustand und das vereinbarte Ergebnis vor der Beauftragung.

Ein zusätzlicher Vor-Ort-Termin umfasst nach der Preisliste den vereinbarten Serviceumfang bis zu zwei Arbeitsstunden; die fixe Anfahrt wird als eigene Position berücksichtigt. Für Wien und Niederösterreich beziehungsweise Burgenland gelten unterschiedliche Anfahrtspositionen. Material, zusätzliche Arbeiten und optionale Dienste werden vorab abgestimmt. Alle ausgewiesenen Preise verstehen sich inklusive Umsatzsteuer. Eine laufende Betreuung entsteht nicht automatisch durch einen einzelnen Einrichtungstermin.