Home Assistant MQTT einrichten: Mosquitto, Broker & Geräte verbinden

MQTT ist eine der wichtigsten Schnittstellen für ein offenes Home Assistant Setup. Über das leichtgewichtige Publish/Subscribe-Protokoll lassen sich Sensoren, Aktoren und ganze Geräteklassen lokal mit Home Assistant verbinden – besonders häufig bei Tasmota, ESPHome, Zigbee2MQTT und vielen DIY-Projekten.

In dieser Anleitung zeige ich dir, wie du MQTT in Home Assistant einrichtest, warum du dafür einen Broker brauchst, weshalb Mosquitto meist die beste Wahl ist und wie du anschließend prüfst, ob Nachrichten sauber ankommen.

Was ist MQTT in Home Assistant?

MQTT ist ein Nachrichtenprotokoll. Geräte senden ihre Daten nicht direkt an Home Assistant, sondern veröffentlichen sie auf sogenannten Topics. Andere Teilnehmer können diese Topics abonnieren.

Der zentrale Vermittler ist der MQTT-Broker. Er nimmt Nachrichten entgegen und verteilt sie an alle Clients, die das jeweilige Topic abonniert haben.

Ein typisches Beispiel:

• Ein Temperatursensor veröffentlicht seinen Wert unter haus/wohnzimmer/temperatur.
• Der MQTT-Broker empfängt die Nachricht.
• Home Assistant hat das Topic abonniert und aktualisiert den entsprechenden Sensor.

Welchen MQTT-Broker solltest du verwenden?

Für ein normales Home-Assistant-System ist der offizielle Mosquitto Broker der naheliegende Weg. Home Assistant empfiehlt diese Variante selbst als einfachen und privaten Einstieg.

Ein öffentlicher MQTT-Broker ist für dein Smart Home keine gute Standardlösung. Zustandsdaten, Steuerbefehle und Geräteinformationen gehören in der Regel in dein eigenes Netzwerk.

Mosquitto Broker in Home Assistant installieren

Wenn du Home Assistant OS oder eine Installation mit Apps verwendest, gehst du so vor:

1. Öffne Einstellungen → Apps.
2. Suche nach Mosquitto broker.
3. Installiere die App.
4. Starte Mosquitto.
5. Öffne anschließend Einstellungen → Geräte & Dienste.
6. Füge die Integration MQTT hinzu beziehungsweise bestätige die automatisch erkannte Integration.

Bei der offiziellen Mosquitto-App kann Home Assistant die Zugangsdaten für die interne Verbindung automatisch erzeugen und verwalten. Für zusätzliche Geräte kannst du bei Bedarf separate Logins definieren.

MQTT ohne Home Assistant OS

Wenn du Home Assistant Container, Core oder eine andere Umgebung verwendest, läuft Mosquitto häufig separat – zum Beispiel als eigener Docker-Container oder auf einem anderen Rechner im Netzwerk.

Dann hinterlegst du in der MQTT-Integration die Adresse des Brokers, den Port und die Zugangsdaten. Für unverschlüsseltes MQTT im lokalen Netz ist Port 1883 üblich; verschlüsselte Verbindungen werden normalerweise über TLS umgesetzt.

MQTT-Integration hinzufügen

Die Integration findest du unter:

Einstellungen → Geräte & Dienste → Integration hinzufügen → MQTT

Wenn du nicht die automatisch konfigurierte Mosquitto-App nutzt, gibst du dort Hostname oder IP-Adresse, Port und Zugangsdaten deines Brokers ein.

Aktuelle Home-Assistant-Versionen setzen einen Broker voraus, der MQTT 5 unterstützt. Mosquitto erfüllt diese Voraussetzung.

MQTT testen: Nachrichten abhören und senden

Bevor du Geräte konfigurierst, lohnt sich ein einfacher Funktionstest.

Öffne die MQTT-Integration und nutze die Funktion zum Abhören eines Topics. Mit # abonnierst du testweise alle Topics. Das ist praktisch zur Fehlersuche, kann in größeren Setups aber sehr viele Nachrichten erzeugen.

Für einen gezielten Test kannst du beispielsweise dieses Topic verwenden:

test/aroundsmart

Veröffentliche anschließend die Nachricht:

Hallo Home Assistant

Wenn die Nachricht im Listener auftaucht, funktionieren Broker und Home-Assistant-Verbindung grundsätzlich.

Was sind MQTT Topics?

Topics sind hierarchisch aufgebaut. Eine sinnvolle Struktur könnte zum Beispiel so aussehen:

haus/wohnzimmer/temperatur
haus/wohnzimmer/luftfeuchte
haus/keller/temperatur
haus/garage/tor/status

Mit Wildcards kannst du mehrere Topics gleichzeitig abonnieren. haus/wohnzimmer/# erfasst beispielsweise alle darunterliegenden Topics im Wohnzimmer.

MQTT Discovery: Geräte automatisch in Home Assistant anlegen

Besonders komfortabel ist MQTT Discovery. Ein kompatibles Gerät veröffentlicht dabei nicht nur Messwerte, sondern zusätzlich eine Konfigurationsnachricht. Home Assistant kann daraus automatisch Geräte und Entitäten erstellen.

MQTT Discovery ist standardmäßig aktiviert. Der Standard-Präfix lautet homeassistant.

Viele verbreitete Projekte unterstützen diesen Mechanismus bereits, darunter beispielsweise Zigbee2MQTT und Tasmota.

Ein einfacher MQTT-Sensor

Wenn ein Gerät keine Discovery-Nachrichten sendet, kannst du MQTT-Entitäten auch manuell anlegen. Für neue Setups solltest du zuerst prüfen, ob sich das Gerät über die Benutzeroberfläche beziehungsweise als MQTT-Gerät hinzufügen lässt, bevor du YAML verwendest.

Ein typisches State-Topic könnte so aussehen:

haus/buero/temperatur

Sendet der Sensor dort beispielsweise 22.4, kann Home Assistant diesen Wert als Temperaturentität verwenden, sofern die Entität entsprechend konfiguriert ist.

Retain: Warum manche MQTT-Werte nach einem Neustart fehlen

MQTT-Nachrichten können mit dem Retain-Flag veröffentlicht werden. Dann speichert der Broker die letzte Nachricht eines Topics und liefert sie neuen Abonnenten direkt nach der Verbindung aus.

Das ist bei Zuständen oft praktisch. Ohne Retain kennt Home Assistant nach einem Neustart den letzten Wert möglicherweise erst wieder, wenn das Gerät erneut sendet.

Bei Befehlen solltest du Retain dagegen mit Bedacht einsetzen. Ein alter gespeicherter Steuerbefehl kann unerwünschte Effekte verursachen.

MQTT und Zigbee2MQTT

Eine sehr häufige Kombination ist Zigbee2MQTT + Mosquitto + Home Assistant. Zigbee2MQTT kommuniziert mit Zigbee-Geräten und stellt deren Daten anschließend über MQTT bereit.

Home Assistant kann diese Geräte über MQTT Discovery weitgehend automatisch übernehmen. Genau deshalb ist ein sauber eingerichteter MQTT-Broker die Grundlage für viele Zigbee2MQTT-Installationen.

MQTT oder native Home-Assistant-Integration?

MQTT ist flexibel, aber nicht immer notwendig. Wenn Home Assistant für ein Gerät bereits eine gute lokale native Integration anbietet, ist diese oft einfacher zu pflegen.

MQTT spielt seine Stärke besonders aus bei:

• DIY-Sensoren und Mikrocontrollern
• Tasmota-Geräten
• Zigbee2MQTT
• selbst gebauten Gateways
• Hersteller-unabhängigen lokalen Datenflüssen

Sicherheit: MQTT nicht offen ins Internet stellen

Ein MQTT-Broker sollte nicht ohne Schutz aus dem Internet erreichbar sein. Verwende Authentifizierung und bei Verbindungen außerhalb eines vertrauenswürdigen lokalen Netzes eine abgesicherte Verbindung.

Für externen Zugriff auf Home Assistant selbst ist ein VPN oder ein dafür vorgesehener Remote-Zugriff die sinnvollere Architektur, statt MQTT-Ports direkt weiterzuleiten.

Typische MQTT-Probleme

• Home Assistant verbindet sich nicht: Hostname, Port, Benutzername und Passwort prüfen.
• Gerät taucht nicht auf: Discovery aktiviert? Stimmt der Discovery-Präfix?
• Werte bleiben unbekannt: Topic im MQTT-Listener prüfen.
• Nach Neustart fehlt der Zustand: prüfen, ob das Gerät den Status regelmäßig sendet oder Retain sinnvoll ist.
• Doppelte Geräte: Unique IDs und Discovery-Konfiguration prüfen.

Unser Fazit

Für Home Assistant ist MQTT vor allem dann stark, wenn du ein offenes, lokales Smart Home aufbauen möchtest. Mit Mosquitto ist der Broker schnell eingerichtet, und MQTT Discovery nimmt dir bei kompatiblen Geräten viel manuelle Konfiguration ab.

Wenn du neu startest, würde ich deshalb nicht mit komplizierter YAML-Konfiguration beginnen: zuerst Mosquitto sauber einrichten, MQTT verbinden, Topics testen und anschließend Discovery-fähige Geräte anbinden.

Mehr Grundlagen zu Home Assistant findest du in unserem Home-Assistant-Einstieg.

Stand: Oktober 2026. Grundlage ist die aktuelle offizielle Home-Assistant-Dokumentation zur MQTT-Integration und zum Mosquitto-Broker.