MQTT ist das Standardprotokoll für Smart-Home-Geräte. Egal ob ESP32, Zigbee-Bridge, Tasmota oder Shelly — fast alles spricht MQTT. Und mit dem Mosquitto Broker direkt in Home Assistant hast du die zentrale Schaltstelle in unter 10 Minuten aufgesetzt.

Was ist MQTT und warum brauchst du es?

MQTT (Message Queuing Telemetry Transport) ist ein leichtgewichtiges Nachrichtenprotokoll. Geräte publishen Nachrichten auf sogenannte Topics, andere Geräte subscriben sich darauf. Dazwischen sitzt der Broker — und der verteilt die Nachrichten.

Warum das für dein Smart Home wichtig ist:

• Schnell: Latenz im Millisekundenbereich — deutlich schneller als Cloud-basierte Lösungen
• Lokal: Alles bleibt in deinem Netzwerk, keine Cloud nötig
• Universell: ESP32, Tasmota, Shelly, Zigbee2MQTT — alles nutzt MQTT
• Zuverlässig: Auch bei instabiler Internetverbindung funktioniert dein Smart Home weiter

Was du brauchst

• Home Assistant OS oder Home Assistant Supervised (für die Add-on-Funktion)
• Einen Home-Assistant-Benutzer für MQTT (erstellen wir gleich)
• Optional: Geräte die MQTT sprechen (ESP32, Shelly, Tasmota-Geräte)

Hinweis: Wenn du Home Assistant in Docker oder Core betreibst, musst du Mosquitto separat installieren. Diese Anleitung fokussiert sich auf die Add-on-Variante.

Schritt 1: Erweiterten Modus aktivieren

Falls noch nicht geschehen:

1. Klicke unten links auf deinen Benutzernamen
2. Scrolle zu Erweiterter Modus
3. Schalte ihn ein

Das gibt dir Zugriff auf alle Add-on-Einstellungen, die wir gleich brauchen.

Schritt 2: Mosquitto Broker Add-on installieren

1. Gehe zu Einstellungen → Add-ons
2. Klicke auf Add-on Store (unten rechts)
3. Suche nach Mosquitto broker
4. Klicke auf Installieren
5. Nach der Installation: Starten aktivieren
6. Optional: Beim Booten starten und Watchdog aktivieren

Einstellungen → Add-ons → Add-on Store → "Mosquitto" → Installieren → Starten

Das Add-on läuft jetzt auf Port 1883 (unverschlüsselt) und 8883 (SSL).

Schritt 3: MQTT-Benutzer anlegen

Mosquitto authentifiziert über Home-Assistant-Benutzer. Leg einen dedizierten Benutzer an:

1. Gehe zu Einstellungen → Personen → Benutzer
2. Klicke auf Benutzer hinzufügen
3. Vergib einen Namen (z.B. mqtt_user)
4. Sicheres Passwort setzen
5. Administrator muss nicht aktiviert sein

Tipp: Nimm nicht deinen Admin-Account für MQTT. Ein separater Benutzer ist sauberer und sicherer.

Schritt 4: MQTT-Integration hinzufügen

Nach der Installation des Add-ons erkennt Home Assistant Mosquitto oft automatisch. Falls nicht:

1. Gehe zu Einstellungen → Geräte & Dienste
2. Klicke auf Integration hinzufügen
3. Suche nach MQTT
4. Wähle MQTT aus
5. Home Assistant verbindet sich automatisch mit dem lokalen Broker

Falls du nach Zugangsdaten gefragt wirst:

• Broker: localhost oder core-mosquitto
• Port: 1883
• Benutzername: Der gerade angelegte MQTT-Benutzer
• Passwort: Das zugehörige Passwort

Schritt 5: Verbindung testen

Überprüfe, ob alles läuft:

1. Gehe zu Einstellungen → Geräte & Dienste → MQTT
2. Klicke auf Konfigurieren
3. Unter “Paket empfangen”: Topic homeassistant/# eingeben und auf Abhören klicken
4. Unter “Paket veröffentlichen”: Topic test/hello mit Payload Hallo Welt eingeben und Veröffentlichen

Wenn im Empfangsbereich deine Testnachricht auftaucht — läuft alles sauber.

Geräte über MQTT anbinden

Tasmota-Geräte

In der Tasmota-Weboberfläche:

1. Gehe zu Configuration → Configure MQTT
2. Host: IP-Adresse deines Home Assistant
3. Port: 1883
4. User: Dein MQTT-Benutzer
5. Password: Zugehöriges Passwort
6. Topic: Eindeutiger Name (z.B. steckdose_buero)

Tasmota-Geräte werden über MQTT Discovery automatisch in Home Assistant erkannt.

Shelly-Geräte

1. Öffne die Shelly-Weboberfläche (IP im Browser)
2. Gehe zu Settings → MQTT
3. Enable MQTT: Ein
4. Server: IP:1883
5. User/Password: MQTT-Zugangsdaten

ESP32 mit ESPHome

In deiner ESPHome-YAML:

mqtt:
  broker: 192.168.1.100  # IP deines Home Assistant
  username: mqtt_user
  password: !secret mqtt_password
  discovery: true

Tipp: Bei ESPHome-Geräten ist die native Home Assistant API meist die bessere Wahl — schneller und einfacher. MQTT bei ESPHome macht vor allem Sinn, wenn du die Geräte auch mit anderen Systemen nutzen willst. Mehr dazu in unserem ESPHome-Einsteiger-Guide.

Mosquitto Konfiguration anpassen

Für die meisten Nutzer reicht die Standardkonfiguration. Falls du mehr Kontrolle brauchst, findest du die Config im Add-on unter Konfiguration:

logins:
  - username: mqtt_user
    password: dein_passwort
require_certificate: false
certfile: fullchain.pem
keyfile: privkey.pem
customize:
  active: false
  folder: mosquitto

Nützliche Optionen:

• Anonymous-Zugriff deaktivieren (ist standardmäßig aus — gut so)
• SSL aktivieren: Sinnvoll wenn MQTT-Geräte über ein unsicheres Netzwerk kommunizieren
• Logging-Level anpassen: Unter Protokoll im Add-on

Troubleshooting

Gerät verbindet sich nicht

1. Logs prüfen: Add-on → Mosquitto → Protokoll
2. Häufigster Fehler: Falscher Benutzername/Passwort
3. Firewall-Check: Port 1883 muss erreichbar sein
4. Ist der Broker gestartet? Status im Add-on prüfen

MQTT-Geräte erscheinen nicht in Home Assistant

• MQTT Discovery muss aktiviert sein (standardmäßig aktiv)
• Gerät muss auf dem Topic homeassistant/ publishen
• Manchmal hilft: MQTT-Integration entfernen und neu hinzufügen

Nachrichten kommen verzögert an

• QoS-Level prüfen: QoS 0 ist schnell aber nicht garantiert, QoS 1 ist zuverlässiger
• Retained Messages: Aktivieren, damit der letzte Zustand auch nach Neustart verfügbar ist
• Netzwerk-Check: Ist die Verbindung zwischen Gerät und Home Assistant stabil?

Nächste Schritte

Mit einem laufenden MQTT-Broker kannst du jetzt:

• Automationen erstellen die auf MQTT-Nachrichten reagieren
• Deinen Stromverbrauch messen mit ESP32 und MQTT
• Zigbee-Geräte über Zigbee2MQTT anbinden
• Eigene Sensoren mit ESP32 und ESPHome bauen

Fazit

Der Mosquitto MQTT Broker ist in Home Assistant in wenigen Minuten installiert und bietet dir die Grundlage für ein schnelles, lokales und zuverlässiges Smart Home. Kein Cloud-Zwang, keine Abhängigkeiten von Herstellern — nur dein Netzwerk und deine Geräte.

Einmal eingerichtet, läuft der Broker im Hintergrund und du musst dich nicht mehr drum kümmern. Einfach Geräte anbinden und loslegen.