Home Assistant kann Zigbee-Geräte entweder direkt über ZHA oder über Zigbee2MQTT einbinden. Beide Wege funktionieren lokal und herstellerübergreifend – unterscheiden sich aber bei Einrichtung, Geräteunterstützung und Flexibilität.
In diesem Guide zeige ich dir, welche Hardware du brauchst, wann ZHA sinnvoller ist und wann Zigbee2MQTT die bessere Wahl sein kann.
Was brauchst du für Zigbee in Home Assistant?
Du benötigst einen Zigbee-Koordinator. Das ist der Funkadapter, der dein Zigbee-Netz verwaltet. Home Assistant empfiehlt für neue ZHA-Setups aktuell den Home Assistant Connect ZBT-2. Der ältere ZBT-1 wird weiterhin unterstützt, ist aber durch den ZBT-2 ersetzt worden.
Wichtig: Home Assistant Green besitzt kein eingebautes Zigbee-Funkmodul. Dort brauchst du deshalb einen externen Zigbee-Adapter. Home Assistant Yellow hat dagegen ein integriertes Funkmodul.
ZHA oder Zigbee2MQTT?
| ZHA | Zigbee2MQTT | |
|---|---|---|
| Einrichtung | direkt in Home Assistant | zusätzlicher Dienst + MQTT |
| MQTT nötig | nein | ja |
| Geräteverwaltung | Home-Assistant-Oberfläche | eigene Zigbee2MQTT-Oberfläche + Home Assistant |
| Komplexität | geringer | höher |
| Flexibilität | hoch | sehr hoch |
Wann würde ich ZHA wählen?
ZHA ist die integrierte Zigbee-Lösung von Home Assistant. Du brauchst keinen separaten MQTT-Broker und keine zusätzliche Zigbee2MQTT-Instanz.
ZHA passt besonders gut, wenn du:
- möglichst wenig Zusatzsoftware möchtest
- Home Assistant OS oder Green verwendest
- deine Zigbee-Geräte direkt in Home Assistant verwalten willst
- ein überschaubares Setup ohne zusätzliche Dienste bevorzugst
Wann ist Zigbee2MQTT interessant?
Zigbee2MQTT läuft als eigener Dienst und kommuniziert über MQTT mit Home Assistant. Dadurch ist die Architektur etwas komplexer, bietet aber sehr viel Kontrolle.
Zigbee2MQTT ist besonders interessant, wenn du:
- bereits MQTT nutzt
- eine eigene Oberfläche für dein Zigbee-Netz möchtest
- viele unterschiedliche Zigbee-Geräte betreibst
- Geräteoptionen und Diagnosewerte möglichst detailliert sehen möchtest
- dein Zigbee-Netz unabhängig von Home Assistant verwalten willst
ZHA in Home Assistant einrichten
- Stecke einen kompatiblen Zigbee-Koordinator ein.
- Starte Home Assistant neu, falls der Adapter noch nicht erkannt wird.
- Öffne Einstellungen → Geräte & Dienste.
- Wähle die automatisch erkannte Zigbee-Integration oder füge Zigbee Home Automation (ZHA) hinzu.
- Wähle den richtigen Funkadapter.
- Home Assistant erstellt anschließend dein Zigbee-Netz.
Danach kannst du über die Zigbee-Verwaltung neue Geräte anlernen.
Zigbee-Gerät mit ZHA anlernen
Versetze zuerst das Gerät in den Pairing-Modus. Bei vielen Sensoren und Lampen geschieht das durch längeres Drücken einer Taste oder einen Werksreset.
Starte anschließend in Home Assistant das Hinzufügen eines Zigbee-Geräts. Sobald das Gerät gefunden wurde, übernimmt Home Assistant die passenden Entitäten.
Zigbee2MQTT in Home Assistant einrichten
Zigbee2MQTT benötigt drei Bausteine:
- einen kompatiblen Zigbee-Koordinator
- einen MQTT-Broker, typischerweise Mosquitto
- die Zigbee2MQTT-Anwendung
Wenn MQTT bei dir noch nicht eingerichtet ist, findest du hier unseren Guide: Home Assistant MQTT einrichten.
1. MQTT vorbereiten
Zigbee2MQTT sendet seine Gerätedaten über MQTT an Home Assistant. Stelle deshalb zuerst sicher, dass Mosquitto und die Home-Assistant-MQTT-Integration sauber funktionieren.
2. Zigbee2MQTT installieren
Unter Home Assistant OS ist die Installation als App/Add-on der einfachste Weg. Zigbee2MQTT unterstützt aktuell nur 64-Bit-Systeme; bei Raspberry Pi wird mindestens ein Pi 4 empfohlen.
3. Adapter auswählen
Beim ersten Start versucht Zigbee2MQTT, den Zigbee-Adapter automatisch zu erkennen. Falls das nicht klappt, hinterlegst du den Gerätepfad und den passenden Adaptertyp manuell.
4. Home-Assistant-Integration aktivieren
Damit Geräte automatisch in Home Assistant erscheinen, aktivierst du in Zigbee2MQTT die Home-Assistant-Integration beziehungsweise MQTT Discovery.
homeassistant:
enabled: trueDer Standard-Discovery-Präfix ist homeassistant.
Kann ich denselben Zigbee-Stick für ZHA und Zigbee2MQTT nutzen?
Nein, nicht gleichzeitig. Ein Zigbee-Koordinator kann nur ein Zigbee-Netz verwalten und nicht parallel von ZHA und Zigbee2MQTT verwendet werden.
Wenn du wechselst, musst du dein Netz migrieren oder Geräte neu anlernen – abhängig von Adapter, Software und Migrationsweg.
Welchen Zigbee-Stick solltest du nehmen?
Für ZHA würde ich bei einem neuen Setup zuerst den offiziellen Home Assistant Connect ZBT-2 prüfen. Home Assistant nennt ihn aktuell als empfohlene Wahl für neue ZHA-Netze.
Bei Zigbee2MQTT solltest du die aktuelle Liste der empfohlenen Adapter prüfen. Unterstützt werden unter anderem viele zStack- und EmberZNet-basierte Adapter.
USB-Verlängerung: kleiner Trick mit großer Wirkung
Ein Zigbee-Adapter sollte nicht direkt neben USB-3.0-Geräten, SSDs oder anderen Funkquellen sitzen. Sowohl Home Assistant als auch Zigbee2MQTT empfehlen bei Problemen eine USB-Verlängerung.
Schon 50 Zentimeter Abstand zum Rechner können Störungen deutlich reduzieren.
Wie funktioniert das Zigbee-Mesh?
Zigbee bildet ein Mesh-Netz. Netzbetriebene Geräte wie Steckdosen oder viele Lampen arbeiten häufig als Router und leiten Nachrichten weiter. Batteriebetriebene Sensoren sind meist Endgeräte.
Ein stabiles Netz entsteht deshalb nicht nur durch einen guten Koordinator, sondern auch durch ausreichend sinnvoll verteilte Router.
Zigbee-Kanal und WLAN
Zigbee und 2,4-GHz-WLAN nutzen denselben Frequenzbereich. Bei Instabilitäten lohnt es sich deshalb, die Kanalplanung zu prüfen.
Ändere den Zigbee-Kanal aber nicht ohne Grund bei einem bestehenden Netz: Je nach Geräten kann das Re-Pairing oder längere Wiederverbindungszeiten verursachen.
ZHA oder Zigbee2MQTT: unsere Empfehlung
Für Einsteiger und möglichst wartungsarme Home-Assistant-Systeme würde ich meist mit ZHA starten. Die Integration ist direkt eingebaut und benötigt keinen zusätzlichen MQTT-Unterbau.
Wenn du ohnehin MQTT nutzt, sehr viele unterschiedliche Zigbee-Geräte betreibst oder möglichst tiefe Kontrolle über Geräteoptionen möchtest, ist Zigbee2MQTT sehr attraktiv.
Home Assistant Green und Zigbee
Home Assistant Green ist eine sehr einfache Home-Assistant-Zentrale, hat aber kein integriertes Zigbee-Funkmodul. Für Zigbee brauchst du daher einen USB-Adapter oder einen passenden Netzwerk-Koordinator.
Mehr dazu findest du in unserem Ratgeber Home Assistant Green.
Unser Fazit
Mit ZHA und Zigbee2MQTT gibt es zwei starke Wege für Zigbee in Home Assistant. ZHA ist einfacher und eng integriert. Zigbee2MQTT ist flexibler, verlangt aber zusätzlich MQTT und einen weiteren Dienst.
Wenn du noch unsicher bist: Starte mit ZHA. Einen komplexeren Zigbee2MQTT-Aufbau würde ich dann wählen, wenn du die zusätzlichen Funktionen wirklich brauchst.
Stand: Oktober 2026. Grundlage sind die aktuellen offiziellen Dokumentationen von Home Assistant ZHA und Zigbee2MQTT.
Keine Kommentare vorhanden