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.

In dieser Anleitung richtest du den Broker ein, bindest deine ersten Geräte an und lernst, wie MQTT unter der Haube funktioniert.

Was ist MQTT und warum brauchst du es?

MQTT (Message Queuing Telemetry Transport) ist ein leichtgewichtiges Nachrichtenprotokoll, das in den 90ern für Satellitenkommunikation entwickelt wurde — und heute das Rückgrat der meisten Smart-Home-Systeme bildet.

Das Prinzip in 30 Sekunden

Gerät A                  Broker                  Home Assistant
(Sensor)                 (Mosquitto)             (Subscriber)
   |                        |                        |
   |--- publish ----------->|                        |
   |  "sensor/temp: 21.5°C" |--- forward ---------->|
   |                        |  "sensor/temp: 21.5°C" |
   |                        |                        |
   |                        |<-- publish ------------|
   |<-- forward ------------|  "switch/licht: ON"    |
   |  "switch/licht: ON"    |                        |

• Geräte publishen (veröffentlichen) Nachrichten auf Topics (z.B. home/wohnzimmer/temperatur)
• Andere Geräte subscriben (abonnieren) sich auf Topics
• Dazwischen sitzt der Broker — der verteilt die Nachrichten an alle Abonnenten

Warum das für dein Smart Home wichtig ist

• Schnell: Latenz im Millisekundenbereich — Licht an in <50ms
• Lokal: Alles bleibt in deinem Netzwerk, keine Cloud nötig
• Universell: Der gemeinsame Nenner für Geräte verschiedener Hersteller
• Zuverlässig: Auch bei instabiler Internetverbindung funktioniert dein Smart Home weiter
• Leichtgewichtig: Läuft auf jedem ESP8266 mit seinen 80KB RAM
• Bidirektional: Nicht nur Daten empfangen, sondern auch Befehle senden

MQTT vs. direkte Integrationen

Wann MQTT? Wenn du Tasmota-Geräte hast, Zigbee2MQTT nutzen willst, mehrere Systeme anbinden möchtest, oder einfach das flexibelste Protokoll willst.

Wann kein MQTT? Wenn du nur ESPHome-Geräte hast (native API ist schneller), oder wenn alles über native HA-Integrationen läuft und du keinen Grund zum Wechsel hast.

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 (Tasmota, Shelly, ESP32, Zigbee2MQTT)

Hinweis: Wenn du Home Assistant in Docker oder Core betreibst, musst du Mosquitto separat installieren (apt install mosquitto oder als Container). 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 (Profil)
2. Scrolle zu Erweiterter Modus
3. Schalte ihn ein

Das gibt dir Zugriff auf alle Add-on-Einstellungen und erweiterte Konfigurationsoptionen.

Schritt 2: Mosquitto Broker Add-on installieren

1. Einstellungen → Add-ons
2. Klicke auf Add-on Store (unten rechts)
3. Suche nach „Mosquitto broker” (das offizielle Add-on)
4. Klicke auf Installieren (dauert 1-2 Minuten)
5. Nach der Installation:
   • Starten aktivieren
   • Beim Booten starten aktivieren (damit der Broker nach einem Neustart automatisch läuft)
   • Watchdog aktivieren (startet den Broker automatisch neu, falls er abstürzt)

Das Add-on läuft jetzt auf:

• Port 1883 — unverschlüsselt (für lokales Netzwerk OK)
• Port 8883 — SSL/TLS verschlüsselt (für Zugriff über Internet)

Schritt 3: MQTT-Benutzer anlegen

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

1. Einstellungen → Personen → Benutzer (Tab „Benutzer”)
2. Klicke auf Benutzer hinzufügen
3. Anzeigename: MQTT
4. Benutzername: mqtt_user
5. Passwort: Ein sicheres Passwort (wird in Geräte-Configs eingetragen)
6. Administrator: ❌ Muss nicht aktiviert sein
7. Speichern

Warum ein separater Benutzer? Sicherheit. Wenn das MQTT-Passwort in einer Gerätekonfiguration kompromittiert wird, hat der Angreifer keinen Admin-Zugang zu deinem Home Assistant. Außerdem siehst du in den Logs klar, welche Verbindungen vom MQTT-User kommen.

Schritt 4: MQTT-Integration hinzufügen

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

1. Einstellungen → Geräte & Dienste
2. Mosquitto erscheint unter „Entdeckt” → Konfigurieren klicken
3. Fertig!

Falls nicht automatisch erkannt:

1. Integration hinzufügen → nach MQTT suchen
2. Broker: localhost oder core-mosquitto
3. Port: 1883
4. Benutzername: mqtt_user (der gerade angelegte)
5. Passwort: Das zugehörige Passwort
6. Absenden

Schritt 5: Verbindung testen

Überprüfe, ob alles läuft:

1. Einstellungen → Geräte & Dienste → MQTT → Konfigurieren
2. Unter „Ein MQTT-Topic abonnieren”:
   • Topic: homeassistant/#
   • Klicke auf Abhören
3. Unter „Ein MQTT-Paket veröffentlichen”:
   • Topic: test/hello
   • Payload: Hallo Welt
   • Klicke auf Veröffentlichen

Wenn im Abhören-Bereich deine Testnachricht auftaucht — der Broker läuft sauber. 🎉

MQTT Explorer (optional aber empfohlen)

Für fortgeschrittenes Debugging: Installiere den MQTT Explorer (Desktop-App, kostenlos):

1. mqtt-explorer.com herunterladen
2. Verbindung konfigurieren: IP deines HA, Port 1883, MQTT-Zugangsdaten
3. Du siehst alle Topics und Nachrichten in Echtzeit — unschlagbar beim Debugging

Geräte über MQTT anbinden

Tasmota-Geräte

In der Tasmota-Weboberfläche (IP im Browser):

1. Configuration → Configure MQTT
2. Host: IP-Adresse deines Home Assistant (z.B. 192.168.1.100)
3. Port: 1883
4. User: mqtt_user
5. Password: Dein MQTT-Passwort
6. Topic: Eindeutiger Name (z.B. steckdose_buero)
7. Full Topic: %prefix%/%topic%/ (Standard belassen)
8. Save → Tasmota verbindet sich

Tasmota-Geräte werden über MQTT Auto-Discovery automatisch in Home Assistant erkannt. Du musst nichts weiter konfigurieren — die Entitäten tauchen von alleine auf.

Shelly-Geräte

Falls du deine Shelly Plugs über MQTT statt der nativen Integration anbinden willst:

1. Shelly Web-UI → Internet & Security → Advanced Developer Settings
2. Enable MQTT: Ein
3. Server: 192.168.1.100:1883 (IP:Port)
4. User/Password: MQTT-Zugangsdaten
5. Speichern → Shelly verbindet sich und wird via MQTT Discovery erkannt

ESP32 mit ESPHome (über MQTT statt nativer API)

In deiner ESPHome-YAML (nur wenn du explizit MQTT statt der nativen API willst):

mqtt:
  broker: 192.168.1.100
  username: mqtt_user
  password: !secret mqtt_password
  discovery: true
  topic_prefix: esphome/wohnzimmer_sensor

Tipp: Bei ESPHome-Geräten ist die native Home Assistant API in den meisten Fällen die bessere Wahl — schneller, einfacher, keine MQTT-Abhängigkeit. MQTT bei ESPHome macht Sinn, wenn du die Daten parallel in anderen Systemen (Grafana, Node-RED, InfluxDB) nutzen willst.

Zigbee2MQTT

Zigbee2MQTT nutzt MQTT als Transportschicht für Zigbee-Geräte. Nach der Installation des Zigbee2MQTT-Add-ons:

1. In der Z2M-Config: Broker-Adresse, User, Passwort eintragen
2. Zigbee-Geräte pairen
3. Die Geräte erscheinen automatisch in Home Assistant via MQTT Discovery

MQTT-Konzepte verstehen

Topics

Topics sind die „Adressen” für Nachrichten. Sie sind hierarchisch aufgebaut:

home/wohnzimmer/temperatur     → 21.5
home/wohnzimmer/licht/state    → ON
home/wohnzimmer/licht/set      → Befehle senden
tasmota/steckdose_buero/POWER  → ON/OFF

Wildcards:

• # → alle darunter liegenden Levels: home/# empfängt alles unter home/
• + → genau ein Level: home/+/temperatur empfängt home/wohnzimmer/temperatur und home/kueche/temperatur

QoS (Quality of Service)

Für Smart-Home-Anwendungen reicht QoS 0 für Sensoren und QoS 1 für Schalter.

Retained Messages

Wenn retain: true gesetzt ist, speichert der Broker die letzte Nachricht auf einem Topic. Neue Subscriber bekommen sofort den letzten Stand — auch nach einem Neustart.

Wichtig für: Lichtstatus, Sensorwerte, alles wo der letzte Zustand relevant ist. Nicht für: Einmalige Ereignisse wie Klingel-Trigger oder Bewegungserkennung.

Mosquitto Konfiguration anpassen

Für die meisten Nutzer reicht die Standardkonfiguration. Falls du mehr Kontrolle brauchst:

Add-on Konfiguration

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

Custom Mosquitto Config

Für erweiterte Einstellungen erstelle /share/mosquitto/mosquitto.conf:

# Maximale Paketgröße (Standard: ~256MB, kann auf IoT-Geräten Probleme machen)
message_size_limit 1048576

# Logging-Level
log_type warning
log_type error

# Persistent Sessions (überlebt Broker-Restart)
persistence true
persistence_location /data/

# Connection Timeout
keepalive_interval 60

SSL/TLS aktivieren

Für verschlüsselte Verbindungen (empfohlen wenn MQTT über das Internet erreichbar ist):

1. Let’s Encrypt Zertifikat in HA einrichten
2. Im Mosquitto-Add-on: require_certificate: true
3. certfile und keyfile auf deine Zertifikate setzen
4. Geräte auf Port 8883 umstellen

Für lokale Netzwerke: Unverschlüsseltes MQTT auf Port 1883 ist OK, solange dein Netzwerk nicht offen ist. Die Nachrichten verlassen nie dein lokales Netz.

Troubleshooting

Gerät verbindet sich nicht

1. Logs prüfen: Add-on → Mosquitto → Protokoll — hier stehen Verbindungsfehler
2. Häufigster Fehler: Falscher Benutzername oder Passwort
3. Firewall: Port 1883 muss erreichbar sein (prüfe ufw status falls aktiv)
4. Broker gestartet? Status im Add-on prüfen — grüner Punkt = läuft

MQTT-Geräte erscheinen nicht in Home Assistant

• MQTT Discovery muss aktiviert sein (ist standardmäßig aktiv)
• Gerät muss auf dem Topic homeassistant/ publishen (Tasmota: SetOption19 1 oder SetOption114 1)
• Manchmal hilft: MQTT-Integration entfernen → HA neu starten → Integration neu hinzufügen
• MQTT Explorer nutzen um zu prüfen, ob das Gerät überhaupt Nachrichten schickt

Nachrichten kommen verzögert an

• QoS-Level prüfen: QoS 0 ist schnell aber unzuverlässig, QoS 1 garantiert Zustellung
• Retained Messages aktivieren: Damit nach einem Reconnect sofort der letzte Zustand da ist
• Netzwerk: Ist die WiFi-Verbindung des Geräts stabil? ping [Gerät-IP] testen
• Mosquitto-Logs: Suche nach „Socket error” oder „Client disconnected”

Broker stürzt ab oder reagiert nicht

• RAM-Verbrauch prüfen: Mosquitto braucht wenig RAM, aber wenn 1000+ Topics mit Retain gespeichert sind, kann es eng werden
• Watchdog aktivieren: Im Add-on → Watchdog einschalten, dann startet er automatisch neu
• Alte Retained Messages löschen: Manchmal sammeln sich Tausende alter Messages an. Mit MQTT Explorer kannst du Topics gezielt löschen

Nützliche MQTT-Automationen

Auf rohe MQTT-Nachrichten reagieren

automation:
  - alias: "MQTT Türklingel"
    trigger:
      - platform: mqtt
        topic: "zigbee2mqtt/tuerklingel"
    action:
      - service: notify.mobile_app_dein_handy
        data:
          title: "🔔 Klingel!"
          message: "Jemand steht an der Tür."

MQTT-Nachricht senden (z.B. an Display)

automation:
  - alias: "Temperatur an MQTT-Display senden"
    trigger:
      - platform: state
        entity_id: sensor.wohnzimmer_temperatur
    action:
      - service: mqtt.publish
        data:
          topic: "display/wohnzimmer/temperatur"
          payload: "{{ states('sensor.wohnzimmer_temperatur') }}"
          retain: true

Weiterführende Artikel

• Zigbee2MQTT vs ZHA — Zigbee-Geräte über MQTT anbinden
• ESP32 mit ESPHome — DIY-Sensoren mit optionaler MQTT-Anbindung
• Automationen für Anfänger — Auf MQTT-Nachrichten reagieren
• Tasmota vs ESPHome — Tasmota nutzt MQTT nativ
• Shelly mit Home Assistant — Shelly über MQTT oder nativ

Fazit

Der Mosquitto MQTT Broker ist in Home Assistant in 10 Minuten installiert und bildet die Grundlage für ein schnelles, lokales und herstellerunabhängiges Smart Home. Einmal eingerichtet, läuft er im Hintergrund und du musst dich nicht mehr drum kümmern — er verteilt zuverlässig die Nachrichten zwischen deinen Geräten.

MQTT ist kein Muss für jedes Setup, aber wenn du Tasmota-Geräte, Zigbee2MQTT oder eigene ESP-Projekte nutzt, führt kein Weg dran vorbei. Und mit dem MQTT Explorer als Debugging-Tool weißt du immer genau, was in deinem Netzwerk passiert.