Kapitel 3

Mosquitto einrichten

Das offizielle Add-on Mosquitto broker ist der MQTT-Broker in deinem Haus. Wir richten ihn so ein, dass er gleich im nächsten Kapitel die CampMatic-Werte holen kann. Die Reihenfolge der Schritte ist dabei wichtiger, als sie aussieht.

8 Minuten Zuletzt geprüft: 22.09.2026 DE EN
Du hast Mosquitto schon?
Dann prüfe nur, ob unter Konfiguration die Option customize aktiv ist und der Ordner /share/mosquitto existiert. Beides brauchen wir gleich. Ansonsten springe direkt zum nächsten Kapitel.

Mosquitto installieren

Öffne Einstellungen → Apps und klicke unten rechts auf App installieren. Suche dort nach Mosquitto broker und installiere es. Starte es noch nicht.

Es heißt jetzt „Apps", nicht mehr „Add-ons"
Home Assistant hat den Bereich umbenannt. Ältere Anleitungen sprechen von Add-ons und einem Add-on-Store — gemeint ist dasselbe. Auf der Infoseite des Programms steht es sogar ausdrücklich: „this app, formerly known as add-on". In dieser Anleitung benutzen wir beide Wörter, weil dir draußen beide begegnen werden.
Bild 3.1Einstellungen → Apps. Nach der Installation steht Mosquitto broker hier und zeigt „Wird ausgeführt". Die Schaltfläche unten rechts heißt „App installieren".
Bild 3.2Die Infoseite von Mosquitto broker. Rechts die Steuerung mit Starten und Neu starten, darunter der Hostname core-mosquitto. Im Text steht die Umbenennung wörtlich: „this app, formerly known as add-on".

Den Ordner anlegen — bevor du weitermachst

Mosquitto soll gleich eine zusätzliche Konfigurationsdatei lesen. Der Ordner dafür muss vorher existieren, sonst startet das Add-on nicht mehr. Lege /share/mosquitto an — zum Beispiel mit dem Add-on File editor oder Terminal & SSH.

Im Terminal-Add-on bash 
mkdir -p /share/mosquitto
Genau hier scheitern die meisten
Schaltest du die Option customize ein, während der Ordner noch fehlt, startet das Add-on und beendet sich sofort wieder. In der Oberfläche steht dann nur gestoppt — ohne jeden Hinweis. Der Grund steht ausschließlich im Protokoll des Add-ons:

Error: Unable to open include_dir '/share/mosquitto'
mosquitto version 2.1.2 terminating
/share ist nicht /config
Das sind zwei verschiedene Orte. Deine configuration.yaml liegt in /config — im Terminal-Add-on auch als /homeassistant sichtbar, das ist derselbe Ordner. /share liegt daneben und ist anfangs leer. Die Bridge-Datei gehört nach /share, nicht zur Konfiguration.

Eigene Konfiguration erlauben

Jetzt erst: Einstellungen → Apps → Mosquitto broker → Konfiguration. Scrolle dort nach unten bis zum zusammengeklappten Bereich Customize und klappe ihn auf. Schalte active ein und trag als folder den Wert mosquitto ein — der steht dort meist schon. Danach Speichern.

Bild 3.3Der aufgeklappte Bereich Customize. Nur zwei Einstellungen: der Schalter active und das Feld folder.
Das ist ein Formular, kein YAML
Manche Anleitungen zeigen an dieser Stelle einen YAML-Block. Home Assistant stellt die Einstellungen inzwischen als Formular dar — ein Schalter und ein Textfeld. Inhaltlich ist es dasselbe.

Zusammen bewirken die beiden Einstellungen, dass Mosquitto beim Start alle .conf-Dateien aus /share/mosquitto/ mitliest.

Jetzt das Programm starten — der Knopf sitzt auf der Infoseite unter Steuerung. Im Reiter Protokoll sollte danach stehen, dass Mosquitto läuft:

Add-on › Protokoll text 
mosquitto version 2.1.2 running
Successfully send discovery information to Home Assistant.
Diese Zeile ist harmlos
Im Protokoll taucht dauerhaft folgendes auf:

New connection from ::1 on port 1883
Protocol error from ::1: First packet not CONNECT (0A)

Das ist die Überwachung, die prüft, ob der Broker erreichbar ist. Kein Fehler, nichts zu tun.

MQTT-Integration hinzufügen

Das Add-on meldet sich bei Home Assistant von selbst an. Unter Einstellungen → Geräte & Dienste erscheint ein Vorschlag für MQTT. Ein Klick auf Bestätigen genügt — Broker, Port und Zugangsdaten füllt Home Assistant selbst aus.

Nichts eintippen
Falls du in anderen Anleitungen liest, du müsstest hier core-mosquitto und Port 1883 von Hand eintragen: Das ist nur nötig, wenn der Vorschlag ausbleibt.
Bevor du weitergehst
  • Das Add-on Mosquitto broker läuft — Status gestartet
  • Der Ordner /share/mosquitto existiert
  • In der Add-on-Konfiguration steht customize: active: true
  • Unter Geräte & Dienste ist die MQTT-Integration eingerichtet