MQTT-Broker mit Home Assistant verbinden¶

Veröffentlicht am 27. August 2026 · Geschätzte Lesezeit: 5 Minuten

MQTT ist ein leichtgewichtiges Nachrichtenprotokoll, über das Sensoren, Schalter und Smart-Home-Dienste Zustände austauschen. Home Assistant verbindet sich als Client mit einem vorhandenen Broker, zum Beispiel Mosquitto, und kann Geräte per MQTT Discovery automatisch anlegen. Die Verbindung und ein sauberer Test dauern ungefähr 20 Minuten.

Voraussetzungen

Ein laufender MQTT-Broker im Heimnetz
Ein eigener MQTT-Benutzer für Home Assistant
Lokale IP-Adresse und Port des Brokers
Ein aktuelles vollständiges Home-Assistant-Backup

1. Broker-Daten vorbereiten¶

Notiere die lokale Adresse des Brokers als <mqtt-ip>. Der unverschlüsselte Standardport ist 1883; Port 8883 wird üblicherweise nur mit korrekt eingerichtetem TLS verwendet.

Lege im Broker einen eigenen Benutzer wie <mqtt-benutzer> für Home Assistant an. Verwende ein langes, einzigartiges Passwort und speichere es in einem Passwortmanager.

Danger

Leite Port 1883 oder 8883 niemals ungefiltert aus dem Internet weiter. Für einen entfernten Broker verwendest du TLS oder ein VPN und schränkst den Benutzer mit Broker-ACLs auf benötigte Topics ein.

2. Home-Assistant-Backup erstellen¶

Öffne Einstellungen → System → Backups und erstelle ein vollständiges Backup. Lade eine zusätzliche Kopie auf einen anderen Rechner oder dein NAS herunter.

Das Backup enthält die Home-Assistant-Konfiguration. Die Konfiguration und Benutzerverwaltung des externen MQTT-Brokers müssen zusätzlich dort gesichert werden.

3. MQTT-Integration hinzufügen¶

Öffne Einstellungen → Geräte & Dienste und wähle Integration hinzufügen. Suche nach MQTT und öffne die Integration.

Trage folgende Werte ein:

Broker: <mqtt-ip> durch die lokale IP-Adresse des Brokers ersetzen
Port: 1883, sofern du kein TLS eingerichtet hast
Benutzername: den eigens angelegten <mqtt-benutzer>
Passwort: das zugehörige Broker-Passwort

Bestätige die Verbindung. Home Assistant speichert die Zugangsdaten intern; trage sie nicht zusätzlich in frei sichtbare YAML-Beispiele ein.

Warning

Verwende nicht localhost oder 127.0.0.1, wenn der Broker in einem anderen Container oder auf einem anderen Rechner läuft. Diese Adresse würde auf das Home-Assistant-System selbst zeigen.

4. Verbindung im Protokoll prüfen¶

Öffne die MQTT-Integration unter Einstellungen → Geräte & Dienste. Sie sollte ohne Fehlermeldung geladen sein.

Bei Problemen öffnest du Einstellungen → System → Protokolle und filterst nach mqtt. Häufige Ursachen sind eine falsche Broker-Adresse, ein nicht erlaubter Benutzer oder ein Port, der durch die Firewall blockiert wird.

5. Test-Topic abonnieren¶

Öffne auf der MQTT-Kachel Konfigurieren. Wähle den Bereich zum Abhören eines Topics und trage dieses Test-Topic ein:

helf-dir-selber/test/#

Das Zeichen # abonniert alle Unterthemen unter helf-dir-selber/test/. Starte das Abhören und lasse das Fenster geöffnet.

6. Testnachricht veröffentlichen¶

Öffne in einem zweiten Browserfenster erneut MQTT → Konfigurieren und wähle Paket veröffentlichen. Trage als Topic Folgendes ein:

helf-dir-selber/test/status

Verwende als Nutzlast diesen einfachen Text:

online

Veröffentliche das Paket. Im ersten Fenster muss die Nachricht sofort erscheinen. Damit ist die Verbindung von Home Assistant zum Broker in beide Richtungen geprüft.

7. Testgerät per MQTT Discovery anlegen¶

Veröffentliche nun eine retained Discovery-Nachricht. Verwende dieses Konfigurations-Topic:

homeassistant/sensor/helf_dir_selber_temperatur/config

Kopiere die folgende JSON-Nutzlast in das Feld für die Nachricht und aktiviere Retain:

{
  "name": "Testtemperatur",
  "unique_id": "helf_dir_selber_testtemperatur",
  "state_topic": "helf-dir-selber/test/temperatur",
  "unit_of_measurement": "°C",
  "device_class": "temperature",
  "state_class": "measurement",
  "device": {
    "identifiers": ["helf_dir_selber_mqtt_test"],
    "name": "MQTT-Testgerät"
  }
}

Die eindeutige ID verhindert, dass Home Assistant dieselbe Test-Entität mehrfach anlegt. Retain sorgt dafür, dass der Broker die Discovery-Konfiguration nach einem Neustart erneut ausliefert.

8. Messwert senden¶

Veröffentliche anschließend einen Zustand auf diesem Topic:

helf-dir-selber/test/temperatur

Nutze als Beispielwert:

21.5

Aktiviere auch hier Retain, damit Home Assistant nach einer erneuten Verbindung den letzten Testwert erhält. Unter Einstellungen → Geräte & Dienste → MQTT sollte nun das Gerät MQTT-Testgerät mit der Entität Testtemperatur erscheinen.

9. Testgerät sauber entfernen¶

Retained Discovery-Nachrichten bleiben im Broker gespeichert und können sonst eine scheinbar gelöschte Entität zurückbringen. Veröffentliche deshalb auf dem Konfigurations-Topic eine leere retained Nachricht:

homeassistant/sensor/helf_dir_selber_temperatur/config

Lasse das Nachrichtenfeld leer, aktiviere Retain und veröffentliche. Wiederhole das für das Zustands-Topic, wenn auch der gespeicherte Testwert verschwinden soll:

helf-dir-selber/test/temperatur

Prüfe danach, ob das Testgerät aus der MQTT-Integration entfernt wurde. Falls es noch angezeigt wird, lade die MQTT-Integration einmal neu.

10. Sicherheit und Rückweg¶

Beschränke den Home-Assistant-Benutzer im Broker auf die Topics, die wirklich benötigt werden. Verwende für Geräte getrennte Konten, wenn du Zugriffe sauber trennen möchtest.

Bei einer fehlerhaften Verbindung öffnest du Einstellungen → Geräte & Dienste → MQTT → Konfigurieren → Neu konfigurieren und korrigierst Adresse oder Zugangsdaten. Wenn du die Integration entfernst, gehen die retained Nachrichten im Broker dadurch nicht automatisch verloren.

Warning

Retained Nachrichten sind nützlich, können aber veraltete Zustände oder Geister-Entitäten erzeugen. Lösche nicht mehr benötigte Discovery-Nachrichten immer durch eine leere retained Nachricht auf demselben Topic.

11. Typische Fehler beheben¶

Verbindung abgelehnt: Prüfe Benutzer, Passwort und ACL-Regeln des Brokers.
Broker nicht erreichbar: Kontrolliere IP-Adresse, Port, Container-Netzwerk und Firewall.
Testnachricht kommt nicht an: Das abonnierte Topic muss exakt passen; helf-dir-selber/test/# umfasst alle verwendeten Testtopics.
Entität erscheint nach Neustart nicht: Die Discovery-Konfiguration sollte retained gesendet oder nach dem Home-Assistant-Birth-Topic erneut veröffentlicht werden.
Gelöschte Entität kehrt zurück: Entferne die retained Konfigurationsnachricht mit einer leeren retained Veröffentlichung.

Grundlage dieser Anleitung sind die aktuelle offizielle MQTT-Integration von Home Assistant und die Hinweise zu Discovery, Birth- und Will-Nachrichten, geprüft am 26. August 2026. Eine ergänzende Video-Anleitung ist Home Assistant MQTT Install and Setup – A Beginner's Guide.

Fertig¶

Home Assistant ist jetzt mit dem MQTT-Broker verbunden und kann Nachrichten senden, empfangen und Discovery-Geräte anlegen. Die Funktionsprüfung ist erfolgreich, wenn die Statusnachricht im abonnierten Topic ankommt, das Testgerät kurz erscheint und sich anschließend ohne zurückbleibende retained Konfiguration entfernen lässt.