Zigbee2MQTT ist für viele Smart-Home-Nutzer längst die bevorzugte Lösung, um Zigbee-Geräte herstellerunabhängig in Home Assistant zu integrieren. Egal ob Aqara, Philips Hue, IKEA Tradfri, Tuya, SONOFF oder hunderte weitere Hersteller – es verbindet alles in einem offenen, transparenten System.

In diesem ausführlichen Guide zeige ich dir, wie du Zigbee2mqtt in Home Assistant installierst, ideal einrichtest und wie du typische Stolperfallen vermeidest.

---

⭐ Warum Zigbee2MQTT?

Viele Nutzer wechseln von ZHA oder anderen Gateways zu Zigbee2MQTT, weil es:

✔ extrem stabil läuft
✔ die größte Gerätekompatibilität unter allen Zigbee-Integrationen bietet
✔ Debug- und Log-Möglichkeiten hat
✔ Cluster-Einstellungen, Exposes und Gruppen sehr flexibel macht
✔ per MQTT über mehrere Systeme nutzbar ist

Wenn du ein größeres Smart-Home betreibst, ist es die beste Basis.

---

🔧 Voraussetzungen

Bevor wir starten, brauchst du folgende Dinge:

Hardware:

• Einen Zigbee-Koordinator wie:
  • SONOFF ZBDongle-P (Empfohlen → EFR32MG21 / Silabs)
  • SONOFF ZBDongle-E (Ti CC2652P)
  • TubeZB Coordinator
  • Home Assistant SkyConnect (ZHA gut, aber mit Zigbee2MQTT ebenfalls nutzbar)

Software:

• Home Assistant (OS, Supervised, Docker oder Core)
• MQTT-Broker (z. B. Mosquitto)

---

🧩 Schritt 1: MQTT-Broker installieren (z. B. Mosquitto)

Damit Zigbee2mqtt kommunizieren kann, benötigen wir einen MQTT-Broker.

Installation über Home Assistant Add-on Store:

1. Einstellungen → Add-ons → Add-on Store
2. Suche nach Mosquitto broker
3. Installieren
4. Starten
5. Unter „Konfiguration“ sicherstellen:
   • Benutzername/Passwort angelegt (optional)
   • Add-on startet automatisch mit Home Assistant

Hinweis:
Der MQTT-Broker wird später die Nachrichten zwischen Home Assistant und deinen Zigbee2MQTT-Geräten übertragen.

---

🧩 Schritt 2: Add-on installieren

Die Installation geht am einfachsten über ein Community-Repository.

Repository hinzufügen:

1. Öffne Home Assistant
2. Einstellungen → Add-ons → Add-on Store
3. Oben rechts auf ⋮ → Repositories
4. Füge dieses Repo hinzu:

https://github.com/zigbee2mqtt/hassio-zigbee2mqtt

5. Nach der Aktualisierung erscheint Zigbee2MQTT im Store.

Add-on installieren:

• Auf Installieren klicken
• Danach Starten
• Aktiviere:
  • „Starten bei Home Assistant Start“
  • „Watchdog“

---

🔌 Schritt 3: Koordinator einbinden

Schließe deinen Zigbee-USB-Stick an dein System an.

Gerätepfad herausfinden:

Unter
Einstellungen → System → Hardware → Alle Geräte → /dev/serial/by-id/
findest du deinen Stick, z. B.:

/dev/serial/by-id/usb-Silicon_Labs_CP2102N_USB_to_UART_Bridge_Controller_abcdef12345-if00-port0

👉 Diesen Pfad kopieren und in der Zigbee2MQTT-Konfiguration eintragen.

---

⚙️ Schritt 4: konfigurieren

Im Add-on auf Konfiguration klicken und folgende Minimal-Konfiguration übernehmen:

mqtt:
  base_topic: zigbee2mqtt
  server: mqtt://localhost
  user: deinmqttuser
  password: deinmqttpasswort

serial:
  port: >-
    /dev/serial/by-id/usb-Silicon_Labs_CP2102N_USB_to_UART_Bridge_Controller_abcdef12345-if00-port0

frontend:
  port: 8099

advanced:
  log_level: info

homeassistant: true
permit_join: false

Wichtig:

• permit_join bleibt standardmäßig false, damit nicht unkontrolliert Geräte beitreten.

Nach dem Speichern das Add-on neu starten.

---

🌐 Schritt 5: Weboberfläche öffnen

Nach dem Start öffnet Home Assistant automatisch den Frontend Link:

👉 http://<deinhomeassistant>:8099

Hier kannst du:

• Logs sehen
• Geräte koppeln
• Firmware aktualisieren
• Gruppen erstellen
• Netzwerkkarte anzeigen

---

🔗 Schritt 6: Home Assistant Integration (MQTT)

Home Assistant erkennt Zigbee2mqtt automatisch über MQTT.

Falls nicht:

1. Einstellungen → Geräte & Dienste
2. Integration hinzufügen
3. MQTT auswählen
4. Verbindung testen

Jetzt tauchen deine Zigbee2mqtt-Geräte automatisch in Home Assistant auf.

---

🧩 Schritt 7: Geräte koppeln

In der Zigbee2MQTT-Weboberfläche:

1. Permit join → ON
2. Gerät in den Pairing-Modus versetzen (Aqara meist 5–10 Sek. Taste halten)
3. Gerät erscheint als neues Device in Zigbee2MQTT
4. Danach taucht es unter MQTT → Home Assistant auf

Tipp:
Platziere Router-Geräte (Zigbee-Steckdosen o. Ä.) zentral – Zigbee ist ein Mesh-Netzwerk und braucht Routen.

---

🛠️ Häufige Probleme & Lösungen

❌ Gerät verbindet sich nicht

➡ Router hinzufügen
➡ Stick weit weg von USB-3.0 Ports (Störquelle!)
➡ Repeater sorgen für bessere Netzabdeckung

❌ Zigbee2MQTT bricht ab

➡ Stick mit USB-Verlängerung betreiben
➡ EMF-Störungen vermeiden
➡ Firmware aktualisieren

❌ Geräte werden nicht korrekt erkannt

➡ Zigbee2mqtt aktualisieren
➡ Manche Geräte benötigen manuelle Exposes
➡ Fallweise Firmware-Update direkt in Zigbee2mqtt durchführen

---

📊 oder ZHA – was ist besser?

Feature	Zigbee2MQTT	ZHA
Gerätekompatibilität	⭐⭐⭐⭐⭐	⭐⭐⭐
Stabilität	⭐⭐⭐⭐⭐	⭐⭐⭐⭐
Debugging / Logs	⭐⭐⭐⭐⭐	⭐⭐
Einsteigerfreundlich	⭐⭐⭐	⭐⭐⭐⭐⭐
Flexibilität	⭐⭐⭐⭐⭐	⭐⭐

Für ambitionierte Installationen → Zigbee2MQTT
Für einfache Systeme → ZHA

---

🚀 Fazit

Mit Zigbee2MQTT erhält dein Home Assistant eine extrem stabile, offene und flexible Zigbee-Integration. Besonders wenn du viele unterschiedliche Hersteller nutzt oder dein Zigbee-Netz erweitern möchtest, ist es die beste Wahl.

Die Installation dauert nur wenige Minuten, bietet aber enorme Möglichkeiten. In Kombination mit MQTT hast du ein echtes Profi-Level-Smart-Home, das du komplett nach deinen Wünschen anpassen kannst.