Ein stabiles, herstellerunabhängiges und vor allem lokales Smart Home Mesh ist der Traum jedes Heimautomatisierers. Wenn du die Nase voll hast von überfüllten Hersteller-Hubs, Cloud-Zwängen und trägen Reaktionszeiten, führt kein Weg an Zigbee2MQTT (Z2M) vorbei.
In dieser ersten Folge unseres ultimativen Zigbee2MQTT-Kurses gießen wir das unerschütterliche Software-Fundament. Wir installieren den Mosquitto MQTT Broker als zentrale Poststelle und richten die Zigbee2MQTT-Anwendung über externe Repositories in deinem Home Assistant ein. Komplett lokal, extrem performant und absolut zukunftssicher.
Inhaltsverzeichnis
- 1 Das Prinzip verstehen: Warum Zigbee2MQTT und was macht der Broker?
- 2 Schritt 1: Installation & Einrichtung des Mosquitto Brokers
- 3 Schritt 2: Zigbee2MQTT Repository & Installation
- 4 Schritt 3: Die Basis-Konfiguration (YAML)
- 5 HA-Versions-Check & Fehlerbehebung
- 6 Was passiert in Folge 2?
- 7 Bewerte diesen Beitrag
- 8 Support & Hilfe
- 9 Meine Produktempfehlungen für dich
- 10 Transparenzhinweis
- 11 Beitragsversion
Das Prinzip verstehen: Warum Zigbee2MQTT und was macht der Broker?
Bevor wir in die Konfiguration springen, ist es wichtig, das Prinzip dahinter zu verstehen. Im Gegensatz zu Home Assistant SkyConnect oder ZHA arbeitet Zigbee2MQTT entkoppelt vom Kern deines Home Assistants. Es nutzt das extrem schlanke Netzwerkprotokoll MQTT (Message Queuing Telemetry Transport).
- Der Mosquitto Broker: Stell dir den Broker wie die zentrale Poststelle deines Smart Homes vor. Er nimmt Nachrichten entgegen und verteilt sie weiter. Er weiß selbst nicht, was in den Nachrichten steht – er sorgt nur dafür, dass sie ankommen.
- Zigbee2MQTT (Z2M): Z2M ist der Übersetzer. Es nimmt die Funksignale deiner Zigbee-Geräte (z. B. von Hue, Aqara oder Sonoff) entgegen, übersetzt sie in das MQTT-Format und schickt sie als Paket an die Poststelle (den Broker).
- Home Assistant: Home Assistant abonniert diese Poststelle, liest die Pakete und erstellt daraus deine Entitäten.
Der riesige Vorteil: Sollte dein Home Assistant einmal neu starten oder abstürzen, läuft dein Zigbee-Netzwerk im Hintergrund völlig ungerührt weiter. Keine Offline-Geräte, kein langes Neu-Anlernen!
Schritt 1: Installation & Einrichtung des Mosquitto Brokers
Zuerst richten wir unsere Poststelle ein. Da wir auf Local-First setzen, installieren wir den Open-Source-Broker Mosquitto direkt als offizielles Add-on in Home Assistant.
1. Neuen MQTT-User in Home Assistant anlegen
Aus Sicherheitsgründen sollte der Broker einen eigenen Systembenutzer bekommen, mit dem sich später auch Zigbee2MQTT anmeldet.
- Navigiere in Home Assistant zu Einstellungen ➔ Personen.
- Klicke oben auf den Reiter Benutzer (Hinweis: Falls du den Reiter nicht siehst, musst du zuerst das „Erweiterte Menü“ in deinem Benutzerprofil aktivieren).
- Klicke unten rechts auf Benutzer hinzufügen.
- Vergib den Namen
mqtt-userund ein sicheres, starkes Passwort. - Aktiviere die Option „Darf sich nur vom lokalen Netzwerk anmelden“ und klicke auf Erstellen.
2. Das Mosquitto Broker Add-on installieren
- Gehe zu Einstellungen ➔ Add-ons und klicke unten rechts auf den Add-on Store.
- Suche nach „Mosquitto Broker“ und klicke darauf.
- Klicke auf Installieren.
- Aktiviere nach der Installation die Schalter für „In der Seitenleiste anzeigen“, „Starten beim Hochfahren“ und „Überwachen“.
- Klicke auf Starten.
3. Die MQTT-Integration aktivieren
Sobald das Add-on läuft, erkennt Home Assistant den neuen Dienst oft automatisch.
- Gehe zu Einstellungen ➔ Geräte & Dienste.
- Unter „Entdeckt“ sollte nun MQTT auftauchen. Klicke auf Konfigurieren und bestätige die Kopplung.
- Falls nicht, klicke unten rechts auf Integration hinzufügen, suche nach *MQTT* und folge den Anweisungen.
Schritt 2: Zigbee2MQTT Repository & Installation
Da Zigbee2MQTT kein offizielles Core-Add-on von Home Assistant ist, müssen wir das offizielle Community-Repository hinzufügen, um die App direkt über das Dashboard verwalten und updaten zu können.
1. Repository hinzufügen
- Navigiere wieder zu Einstellungen ➔ Add-ons ➔ Add-on Store.
- Klicke oben rechts auf die drei Punkte (Menü) und wähle Repositories.
- Kopiere die folgende URL, füge sie in das Feld ein und klicke auf Hinzufügen:
https://github.com/zigbee2mqtt/hassio-zigbee2mqtt
- Schließe das Fenster. Der Store lädt kurz neu. Scrollst du nun ganz nach unten, findest du die Sektion „Zigbee2MQTT“.
2. Z2M Installieren
- Klicke auf das Standard-Add-on Zigbee2MQTT (nicht die Edge-Version, diese ist nur für Entwickler!).
- Klicke auf Installieren. Das kann je nach System (Raspberry Pi, Mini-PC oder Synology VM) ein paar Minuten dauern.
- Aktiviere auch hier „Starten beim Hochfahren“ und „In der Seitenleiste anzeigen“. Wichtig: Klicke noch nicht auf Starten! Wir müssen zuerst die Grundkonfiguration hinterlegen.
Schritt 3: Die Basis-Konfiguration (YAML)
Damit Zigbee2MQTT weiß, wo sich unsere Poststelle befindet, müssen wir die Konfiguration anpassen.
- Klicke im Add-on Zigbee2MQTT oben auf den Reiter Konfiguration.
- Du siehst nun die YAML-Eingabemaske. Lösche den vorhandenen Inhalt oder passe ihn exakt so an, dass dein zuvor angelegter Benutzer hinterlegt ist.
Hier ist das saubere, fehlerfreie Konfigurations-Template für deine Basis-Installation. Kopiere es dir einfach heraus:
```yaml
data_path: /config/zigbee2mqtt
socat:
enabled: false
master: pty,raw,echo=0,link=/tmp/ttyZ2M0,mode=777
slave: tcp-listen:8485,keepalive,nodelay,reuseaddr,keepalive
options: "-d -d"
inherited: false
mqtt:
server: mqtt://core-mosquitto:1883
user: mqtt-user
password: DEIN_ZUVOR_ANGELEGTES_PASSWORT
serial: {}
```
Wichtige Hinweise zur YAML-Eingabe:
- Ersetze
DEIN_ZUVOR_ANGELEGTES_PASSWORTmit dem exakten Passwort desmqtt-user, den du in Schritt 1 angelegt hast. - Die Zeile
serial: {}lassen wir in dieser Folge bewusst komplett leer. Warum? Weil das die Hardware-Meisterklasse ist! Wie wir deinen USB-Stick oder LAN-Coordinator (wie den SMLIGHT MR1) ermitteln und dort fehlerfrei einbinden, zeige ich dir exakt in der nächsten Folge.
Klicke unten rechts auf Speichern.
HA-Versions-Check & Fehlerbehebung
Bevor du den Startknopf drückst, werfen wir einen kurzen Blick auf die aktuelle Kompatibilität.
- HA Core Kompatibilität: Getestet und voll kompatibel mit Home Assistant Core 2026.5/2026.6.
- Wichtiger Breaking Change Hinweis: In neueren Home Assistant Versionen wurde die Authentifizierung für Add-ons verschärft. Stelle unbedingt sicher, dass der angelegte
mqtt-userüber ein starkes Passwort verfügt und nicht mit deinem primären Admin-Konto identisch ist, da Home Assistant Anmeldeversuche von externen Apps mit Admin-Rechten aus Sicherheitsgründen blockieren kann.
Was passiert in Folge 2?
Das Software-Fundament steht und wartet auf seinen Einsatz. Im nächsten Beitrag widmen wir uns voll und ganz der Hardware: Welcher Coordinator passt am besten zu dir? Wir vergleichen den klassischen Sonoff USB-Stick, den Home Assistant Connect ZBT-1 (SkyConnect) und professionelle LAN-Lösungen wie den SmLight MR1. Zudem zeige ich dir, wie du den seriellen Port ausliest und das System startest.
Hast du Fragen zur Installation oder gab es Probleme beim Anlegen des MQTT-Users? Schreib es mir direkt unten in die Kommentare – die Community und ich helfen dir sofort weiter!
Nächster Schritt:Home Assistant – Leitfaden (DE)
Bewerte diesen Beitrag
Dein Feedback ist mir wichtig! Hat dir der Beitrag geholfen oder fehlte dir etwas? Schreib’s mir gerne in die Kommentare oder bewerte den Artikel – so kann ich meine Inhalte noch besser machen.
Support & Hilfe
Du hast eine Frage oder brauchst Unterstützung? Über meinen Support kannst du ganz einfach ein Ticket erstellen – ich helfe dir so schnell wie möglich weiter.
Meine Produktempfehlungen für dich
Einige der folgenden Produktlinks sind sogenannte Affiliate-Links. Wenn du darüber etwas kaufst, erhalte ich eine kleine Provision – für dich bleibt der Preis natürlich gleich.
- ✔ Leistungsstarker Raspberry Pi 5 mit 8GB RAM: Ideal für anspruchsvolle Projekte wie Smart Home, Home Assistant oder Retro Gaming – flüssige Performance für Einsteiger und Profis.
- ✔ Original 27W Netzteil: Stabile und zuverlässige Stromversorgung für Ihren Raspberry Pi 5.
- ✔ Original Gehäuse mit Lüfter: Schützt Ihren Raspberry Pi und sorgt für optimale Kühlung bei intensiver Nutzung.
- ✔ 128GB Speicherkarte: Bietet großzügigen Speicherplatz für Ihr Betriebssystem, Anwendungen und Dateien.
- ✔ USB-Kartenleser für Speicherkarten: Einfache und schnelle Einrichtung ihres Betriebssystem am PC oder Laptop.
- ✔ Aluminium-Kühlkörper: Zusätzliche Kühlung für eine zuverlässige Leistung und Langlebigkeit.
- ✔ 4K Micro-HDMI-Kabel 1 Meter: Perfekt für gestochen scharfe Videoausgabe auf kompatiblen 4K-Monitoren oder Fernsehern.
- ✔ Hochwertige db-tronic-Verpackung: Robuste und elegante Verpackung, ideal für sicheren Versand und als Geschenk geeignet.
- Vorgeflasht mit Z-Stack 3.x.0-Koordinator-Firmware
- Basis auf TI CC2652P + CP2102(N)
- Dieser zigbee 3.0 USB-Dongle-p als ZigBee-Gateway zur Verwaltung von Untergeräten in Open-Source-Plattformen mit HomeAssistant oder Zigbee2MQTT
- SMA-Schnittstelle externe Antenne,Aluminiumgehäuse reduziert effektiv Signalstörungen von Peripheriegeräten, +20dBm Ausgangsverstärkung
- Kann in ZigBee-Routing-Firmware flashen, als Router im ZigBee-Netzwerk die Netzwerkreichweite erweitern
- 1.SLZB-MR1: Ein Multi-Radio-, Dual-Antennen-Zigbee- und Thread-Koordinator basierend auf den Modulen CC2652P7 und EFR32MG21. Er integriert Zigbee und Thread in einem einzigen Gerät. Kann als Zigbee 3.0-Gateway in den Open-Source-Automatisierungsplattformen – Zigbee2MQTT, Home Assistant, ZHA – verwendet werden.
- 2.Funktioniert in beiden Modi – LAN und USB. Der Modus kann über die Firmware oder per Knopfdruck geändert werden.
- 3. Sie können einem Server beliebig viele Zigbee-Koordinatoren hinzufügen. So können Sie problemlos verschiedene Räume und Gebäude abdecken und sie mit derselben Home Assistant-Instanz verbinden.
- 4. Das Gerät kann entweder über PoE oder USB-C mit Strom versorgt werden.
- 5. Es gibt zwei separate Antennen - eine für jeden SoC - und beide sind mit Leistungsverstärkern ausgestattet, die eine Sendeleistung von über 20 dBm ermöglichen. Die Antennen selbst haben einen Gewinn von mindestens 5 dBi.
Transparenzhinweis
*Die mit Sternchen markierten Links sind sogenannte „Affiliate-Links“. Als Amazon-Partner verdiene ich an qualifizierten Verkäufen. Wird über diese ein Einkauf getätigt, werde ich mit einer kleinen Provision beteiligt – ohne das Kosten für dich entstehen. Vielen Dank für deinen Support!
Gerne darfst du aber auch meine Arbeit über eine Pay Pal Spende unterstützen.
Beitragsversion
Dieser Beitrag wird regelmäßig aktualisiert, um dir stets die aktuellsten Informationen zu bieten.