Featured image of post Zigbee und ZHA in Home Assistant: Schritt-für-Schritt-Guide für Einsteiger DE

Zigbee und ZHA in Home Assistant: Schritt-für-Schritt-Guide für Einsteiger

Zigbee und ZHA in Home Assistant einrichten: Schritt-für-Schritt-Anleitung für Einsteiger mit Koordinator-Empfehlungen, Router-Setup, Pairing und Troubleshooting.

Zigbee ist eine der beliebtesten Technologien im Bereich der Smart-Home-Automation – und das aus gutem Grund. Mit seiner energieeffizienten und stabilen Mesh-Netzwerkarchitektur hebt es sich von Alternativen wie WLAN oder klassischem Bluetooth ab und bietet eine flexible Grundlage für die Integration smarter Geräte. Egal, ob es um die Steuerung von Lampen, Steckdosen, Sensoren oder Schaltern geht: Zigbee ermöglicht die reibungslose Kommunikation zwischen unterschiedlichsten Geräten, selbst wenn sie von verschiedenen Herstellern stammen.

Doch wie beginnt man mit Zigbee? Welche Hardware und Software werden benötigt, und welche Stolpersteine gilt es zu vermeiden? In diesem Beitrag zeige ich dir, wie du mit der ZHA-Integration von Home Assistant startest. ZHA steht für „Zigbee Home Automation“ und bietet eine unkomplizierte Möglichkeit, Zigbee-Geräte direkt in Home Assistant zu integrieren. Gemeinsam richten wir ein Zigbee-Gateway ein, koppeln erste Geräte und werfen einen Blick auf typische Probleme – und wie du sie lösen kannst.

Am Ende dieses Beitrags wirst du in der Lage sein, dein erstes Zigbee-Netzwerk aufzubauen und mit Home Assistant zu steuern. Lass uns gemeinsam in die Welt von Zigbee eintauchen!


Schnellstart: Zigbee-Hardware für Home Assistant mit ZHA

Wenn du direkt loslegen möchtest und vor allem wissen willst, welcher Koordinator sich bewährt hat, hier meine aktuelle Empfehlung:

Ablauf für den schnellen Start (10 Minuten)

Wenn du ohne viel Theorie direkt starten willst, nutze diese Reihenfolge:

  1. Koordinator platzieren und mit dem Host verbinden
    Möglichst frei positionieren (bei USB ideal mit Verlängerung), nicht direkt neben WLAN-Router, USB-3-Hub oder Metallflächen.
  2. ZHA einrichten und Koordinator wählen
    In Home Assistant unter Geräte & Dienste „Zigbee Home Automation“ hinzufügen und den Adapter auswählen. USB-Koordinatoren werden meist automatisch erkannt, Netzwerk-Koordinatoren benötigen die IP-/Port-Konfiguration. Details dazu findest du im SMLIGHT SLZB-06M Hands-on.
  3. Router einbinden und pairen
    1-2 Router (Steckdosen/Repeater) zuerst in ZHA koppeln, damit direkt ein stabiles Grund-Mesh entsteht.
  4. Endgeräte pairen
    Danach Sensoren, Taster und andere batteriebetriebene Geräte einbinden.
  5. Kurzer Stabilitätscheck
    10-15 Minuten beobachten: kommen Zustandsänderungen zuverlässig an, dann weitere Geräte hinzufügen.

Wenn du bei Schritt 5 schon Aussetzer siehst, nicht sofort alles neu aufsetzen: meist reichen bessere Koordinator-Positionierung oder ein zusätzlicher Router.

Phoscon ConBee III

Phoscon ConBee III

Zigbee-USB-Gateway

Moderner ConBee-Stick für deCONZ/Phoscon & Co.

* Dies ist ein Affiliate-Link. Wenn du über diese Links einkaufst, unterstützt du diesen Blog - ohne zusätzliche Kosten für dich.

Einen detaillierten Vergleich dieser Koordinatoren findest du im Beitrag:
Die besten Zigbee-Koordinatoren für Home Assistant – Vergleich, Test & Empfehlungen.


Zigbee-Netzwerk in Home Assistant: Diese Komponenten brauchst du

Zigbee ist ein drahtloses Protokoll für viele kleine Smart-Home-Geräte. Der große Vorteil gegenüber WLAN: Das Netz ist als Mesh aufgebaut. Geräte können Nachrichten weiterreichen, was Reichweite und Stabilität erhöht.

Für den Start mit ZHA brauchst du genau diese Bausteine:

  1. Koordinator: Startet und verwaltet dein Zigbee-Netzwerk.
  2. Router: Dauerstrom-Geräte, die das Mesh erweitern und stabilisieren.
  3. Endgeräte: Sensoren, Taster, Aktoren, die Daten liefern oder Aktionen ausführen.
  4. Home Assistant + ZHA: Die Software-Schicht für Verwaltung und Automationen.

Die vier Teile greifen direkt ineinander: Home Assistant schickt einen Befehl an den Koordinator, dieser verteilt ihn über das Mesh (ggf. über Router), und das Endgerät bestätigt den Status zurück. Wenn eines dieser Glieder schwach ist, entstehen typische Probleme wie verzögertes Schalten, unzuverlässiges Pairing oder sporadische Ausfälle.

Für Einsteiger ist vor allem wichtig: Ein starker Koordinator allein löst keine Funkprobleme. Die Stabilität kommt in der Praxis aus guter Platzierung und genug Routern an den richtigen Stellen.

Koordinator (Gateway)

Damit dieser Beitrag ein Einrichtungs-Guide bleibt, findest du hier bewusst nur den Kurzvergleich mit Vor-/Nachteilen. Die langen Tests und Benchmarks liegen in den verlinkten Detailartikeln.

Bei der Auswahl solltest du vor allem auf den Einsatzort achten:

  • Läuft Home Assistant zentral und frei im Haus, reicht ein guter USB-Koordinator oft völlig aus.
  • Steht dein HA-Host im Serverschrank, Keller oder Technikraum, ist ein LAN/PoE-Koordinator meist die bessere Wahl.
  • Wenn du bewusst flexibel bleiben willst (z. B. Standortwechsel, spätere Thread-Tests), lohnt sich ein Modell mit mehr Betriebsmodi.
Meine Empfehlung
SMLIGHT SLZB-06M

SMLIGHT SLZB-06M

PoE Zigbee/Thread-Gateway

Sehr flexibles Gateway für zentrale Platzierung per LAN/PoE.

Stärken

  • PoE/LAN für zentrale Position
  • Webinterface mit Remote-Updates
  • Zigbee und Thread per Firmware möglich

Einschränkungen

  • Teurer als USB-Sticks
  • Mehr Setup-Optionen bei der Ersteinrichtung

Hands-on lesen

Budget-Empfehlung
Sonoff ZBDongle-E

Sonoff ZBDongle-E

USB-Zigbee mit ext. Antenne

Starker Preis-Leistungs-Kandidat für klassische USB-Setups.

Stärken

  • Günstig und weit verbreitet
  • Gute Funkleistung
  • Direkt mit ZHA nutzbar

Einschränkungen

  • USB-Standort oft nicht optimal
  • Updates weniger komfortabel als bei LAN-Gateways

Erfahrungsbericht lesen

Phoscon ConBee III

Phoscon ConBee III

Zigbee-USB-Gateway

Solides USB-Gateway, besonders interessant mit deCONZ/Phoscon.

Stärken

  • Gute Geräteunterstützung
  • Stabiles Ökosystem mit deCONZ
  • Plattformübergreifend nutzbar

Einschränkungen

  • Für reines ZHA oft nicht die direkteste Wahl
  • Kein PoE/LAN-Betrieb

Vergleich lesen

* Dies ist ein Affiliate-Link. Wenn du über diese Links einkaufst, unterstützt du diesen Blog - ohne zusätzliche Kosten für dich.

Die maximale Netzgröße hängt in der Praxis stärker von der Mesh-Qualität ab als vom Stick selbst: Anzahl/Position der Router, Funkstörungen und Kanalwahl sind meist entscheidender.

Als grobe Startregel funktionieren viele Setups stabil mit: 1 Koordinator + 2 bis 4 Router + 5 bis 20 Endgeräten. Danach kann man das Netz schrittweise erweitern.


Router-Geräte

Router-Geräte sind für Reichweite und Stabilität oft wichtiger als der Koordinator. Für den Start reichen meist 1-2 gut platzierte Router in Flur/Übergangsbereichen.

Entscheidend ist nicht nur die Anzahl, sondern die Verteilung:

  • Router entlang typischer Laufwege platzieren (Flur, Treppenhaus, Übergang zwischen Etagen).
  • Nicht direkt neben WLAN-APs, USB-3-Hubs oder massiven Metallflächen positionieren.
  • Erst Router setzen, dann batteriebetriebene Endgeräte pairen, damit sie direkt gute Elternknoten finden.
Aeotec Range Extender Zi

Aeotec Range Extender Zi

Dedizierter Zigbee-Repeater

Wenn du gezielt Funklöcher schließen willst, ohne zusätzliche Schaltfunktion.

Stärken

  • Einfaches Plug-and-Play
  • Sehr geringer Eigenverbrauch
  • Optimiert als reiner Router

Einschränkungen

  • Keine Zusatzfunktion außer Routing
  • Preis pro Router höher als bei Smart Plugs

Routing-Praxis lesen

NOUS A1Z

NOUS A1Z

Zigbee-Steckdose mit Messung

Kombiniert Router-Rolle mit Schaltfunktion und Verbrauchsmessung.

Stärken

  • 16 A Schaltleistung
  • Verbrauchsmessung inklusive
  • Guter Preis pro Router

Einschränkungen

  • Größer als dedizierte Repeater
  • Nicht jeder Einsatzort braucht eine Steckdose

Routing-Praxis lesen

Aqara Zigbee Smart Plug

Aqara Zigbee Smart Plug

Zuverlässiger Standard-Router

Sehr gute Router-Stabilität in vielen gemischten Zigbee-Setups.

Stärken

  • Stabil im Dauerbetrieb
  • Unauffällige Alltagsnutzung
  • Breit im Markt verfügbar

Einschränkungen

  • Meist etwas teurer als Budget-Plugs
  • Features je nach Region/Modell unterschiedlich

Routing-Praxis lesen

* Dies ist ein Affiliate-Link. Wenn du über diese Links einkaufst, unterstützt du diesen Blog - ohne zusätzliche Kosten für dich.


Endgeräte

Endgeräte sind die eigentlichen „smarten Komponenten“ in deinem Zuhause: Sensoren (Temperatur, Luftfeuchtigkeit, Bewegung, Helligkeit), Schalter, Taster, Aktoren und mehr. Sie verbinden sich entweder direkt mit dem Koordinator oder über Router-Geräte.

Für Einsteiger haben sich u. a. bewährt:

  • Temperatur-/Luftfeuchtigkeitssensoren (z. B. Aqara, Sonoff)
  • Bewegungsmelder
  • Tür-/Fensterkontakte
  • Funk-Taster für Szenensteuerung

Hier sind vier Endgeräte, die ich in den verlinkten Artikeln bereits im Einsatz zeige:

* Dies ist ein Affiliate-Link. Wenn du über diese Links einkaufst, unterstützt du diesen Blog - ohne zusätzliche Kosten für dich.

Bei batteriebetriebenen Endgeräten ist normales Verhalten oft missverständlich: Viele melden nicht permanent, sondern nur bei Zustandsänderung oder im festen Intervall. Das ist kein Fehler, sondern Teil des Energiespar-Konzepts.

Wenn ein Sensor „nicht sofort“ reagiert, helfen meist drei einfache Checks:

  1. Sensor kurz wecken (Taste am Gerät drücken) und erneut testen.
  2. Prüfen, ob in der Nähe ein stabiler Router erreichbar ist.
  3. Gerät einmal neu pairen, falls es an einem ungünstigen Knoten hängt.

Wenn du konkrete Modelle suchst, ist der Sensor-Überblick hier ein guter Start: Zigbee-Temperatursensoren in Home Assistant: Einrichten und optimieren.


Home Assistant und ZHA als Software-Basis

Für die Steuerung deines Zigbee-Netzwerks ist Home Assistant die zentrale Software. Die aktuelle Version sollte bereits installiert sein, bevor du mit der Zigbee-Einrichtung beginnst.

Die Zigbee Home Automation (ZHA)-Integration ist direkt in Home Assistant enthalten und bietet einen sehr einfachen Einstieg:

  • keine zusätzliche Software nötig
  • kein externer MQTT-Broker erforderlich
  • Integration, Geräteliste und Automatisierungen komplett in Home Assistant

Für die meisten Leser ist das der beste Startpunkt, weil du damit schneller zu einem funktionierenden Netz kommst und Fehlerquellen in der Erstphase reduzierst. Wenn dein Setup später wächst oder du spezielle Geräte-/Debug-Features brauchst, kannst du immer noch auf Zigbee2MQTT oder deCONZ wechseln.

Später kannst du – falls du mehr Kontrolle, spezielle Features oder andere Integrationen brauchst – immer noch auf Zigbee2MQTT oder deCONZ wechseln.

Zusätzliche Tools, die helfen:

  • Zigbee-Mesh-Karte (z. B. „Zigbee Network Map“) zur Visualisierung des Netzes
  • Terminal-/SSH-Zugriff auf Home Assistant für Debugging & Log-Analyse

ZHA in Home Assistant einrichten: Schritt-für-Schritt

Sobald die notwendige Hardware bereitsteht und Home Assistant läuft, geht es an die Einrichtung von ZHA.

Einrichtung des Zigbee-Koordinators

Automatische Erkennung des Zigbee Koordinators

  1. Koordinator anschließen

    • USB-Stick (z. B. Sonoff oder ConBee) direkt oder über ein USB-Verlängerungskabel an den Host anschließen.
    • LAN-/PoE-Geräte wie der SMLIGHT SLZB-06M im Netzwerk verbinden und ggf. per Weboberfläche konfigurieren.
  2. Erkennung in Home Assistant prüfen
    Unter Einstellungen > System > Hardware prüfen, ob der Koordinator sichtbar ist (z. B. als ttyUSB0 bei USB-Sticks oder als serielle/Netzwerk-Schnittstelle).

  3. ZHA-Integration hinzufügen

    • Einstellungen > Geräte & Dienste > Integration hinzufügen
    • „Zigbee Home Automation“ auswählen
    • passenden Koordinator-Port / -Adapter auswählen
    • Assistent durchlaufen

Nach Abschluss sollte der Koordinator als Gerät in Home Assistant sichtbar sein und ZHA bereit für das Pairing neuer Zigbee-Devices.

Hinzufügen von Zigbee-Geräten

Hinzufügen neuer Zigbee Geräte

Um neue Geräte hinzuzufügen:

  1. Gerät in den Pairing-Modus versetzen (häufig durch langes Drücken eines Knopfes).
  2. In Home Assistant in der ZHA-Integration „Gerät hinzufügen“ wählen.
  3. Warten, bis das Gerät gefunden wird, Namen vergeben, Raum zuweisen.

Gerade bei batteriebetriebenen Geräten kann es ein paar Sekunden dauern, bis alle Entities korrekt auftauchen.

Optimierung des Zigbee-Mesh-Netzwerks

Zigbee Mesh Topology

Nach dem Koppeln lohnt ein Blick auf die Netzwerktopologie (z. B. über die „Zigbee Network Map“):

  • Erreichbarkeit von Geräten prüfen
  • Router-Positionierung optimieren
  • „Sackgassen“ im Netz vermeiden

Wenn Geräte häufig die Verbindung verlieren, hilft oft:

  • zusätzlicher Router in der Nähe
  • Koordinator anders platzieren (höher, zentraler, weg vom WLAN-Router)
  • ggf. Kanalwahl des WLAN anpassen, um Überschneidungen zu minimieren

Für tiefergehende Fehleranalyse siehe auch:
ZHA Issue und Zigbee Gateway – Fehleranalyse und Tipps.


Häufige Zigbee- und ZHA-Probleme in Home Assistant lösen

Probleme beim Pairing von Geräten

Ein häufiges Problem ist die Schwierigkeit, neue Zigbee-Geräte mit dem Netzwerk zu koppeln. Dies kann an mehreren Faktoren liegen. Oft befindet sich das Gerät außerhalb der Reichweite des Koordinators oder der Router. Eine weitere Ursache kann ein nicht korrekt aktivierter Pairing-Modus sein. Viele Geräte haben spezifische Methoden, um in den Pairing-Modus zu wechseln, wie das Gedrückthalten eines Knopfes über mehrere Sekunden.

Lösung: Stelle sicher, dass das Gerät näher am Koordinator oder an einem Router positioniert ist, während du es koppelst. Lies die Bedienungsanleitung des Geräts, um den Pairing-Prozess genau zu verstehen. Sollte das Gerät nicht gefunden werden, setze es zurück und starte den Vorgang erneut. Auch das Neustarten des Koordinators oder des Home Assistant-Hosts kann manchmal Abhilfe schaffen.

Instabilität des Netzwerks

Ein instabiles Zigbee-Netzwerk zeigt sich oft durch sporadische Verbindungsabbrüche oder verzögerte Reaktionen von Geräten. Diese Probleme treten häufig auf, wenn zu wenige Router im Netzwerk vorhanden sind oder Störungen durch andere Funkfrequenzen, wie WLAN, auftreten.

Lösung: Achte darauf, dass du ausreichend Router-Geräte wie smarte Steckdosen oder Repeater in deinem Netzwerk verwendest, um die Mesh-Struktur zu stärken. Positioniere den Koordinator und die Router so, dass sie große Flächen abdecken und sich gegenseitig erreichen können. Vermeide es, den Koordinator in unmittelbarer Nähe zu WLAN-Routern oder anderen Funkquellen zu platzieren, die Interferenzen verursachen könnten. Falls möglich, konfiguriere die Zigbee-Frequenz so, dass sie nicht mit deinem WLAN-Kanal überlappt.

Firmware-Updates und Kompatibilität

Manchmal sind Zigbee-Geräte aufgrund veralteter Firmware oder Inkompatibilitäten schwierig in das Netzwerk zu integrieren. Einige Geräte funktionieren nicht optimal oder verlieren ständig die Verbindung.

  • Regelmäßig prüfen, ob es Firmware-Updates für Koordinator und Geräte gibt.
  • Bei SMLIGHT: Updates bequem über die Weboberfläche einspielen.
  • Bei Sonoff/ConBee: Hersteller-Dokumentation bzw. Community-Anleitungen nutzen.

Unerwartetes Verhalten von Geräten

Ein weiteres Problem sind Geräte, die unerwartet reagieren, wie z. B. plötzliche Aktivierungen oder nicht ausgelöste Aktionen. Dies kann durch Fehlkonfigurationen oder mangelnde Integration verursacht werden.

Lösung: Überprüfe die Konfigurationen in Home Assistant, insbesondere Automatisierungen und Szenen, die mit dem betroffenen Gerät verknüpft sind. Teste das Gerät in einer einfachen Umgebung, um sicherzustellen, dass die Hardware ordnungsgemäß funktioniert. In komplexeren Setups hilft es, Log-Dateien zu analysieren, um die Ursache des Problems zu identifizieren.

Empfehlungen für Einsteiger

Starte klein

Beginne mit:

  • 1 Koordinator
  • 1–2 Router-Geräten (z. B. Steckdosen)
  • 2–5 Endgeräten (Sensoren, Schalter)

So bekommst du ein Gefühl für Verhalten, Latenzen und Reichweiten, ohne dich direkt zu überfordern.

Wähle etablierte Geräte

Setze auf Marken und Geräte, die:

  • von der Community gut dokumentiert sind
  • in ZHA/Zigbee2MQTT bekannte Templates haben
  • Zigbee 3.0 unterstützen

Router bewusst platzieren

  • In Fluren, offenen Räumen, zentralen Punkten
  • Nicht hinter dicken Wänden oder in Metallregalen
  • Lieber ein, zwei Router „zu viel“ als zu wenig

Nutze ZHA als Einstieg

ZHA ist ideal, wenn du:

  • so wenig Zusatz-Software wie möglich möchtest
  • direkt in Home Assistant bleiben willst
  • einen Clean-Setup ohne MQTT-Overhead bevorzugst

Später kannst du immer noch zu Zigbee2MQTT oder deCONZ wechseln, wenn du merkst, dass dir bestimmte Features fehlen.


ZHA vs. Zigbee2MQTT vs. deCONZ: Was passt zu dir?

ZHA punktet vor allem mit:

  • direkter Integration in Home Assistant
  • einfacher Einrichtung
  • guter Geräteunterstützung für viele typische Zigbee-Komponenten
  • solider Stabilität durch aktive Weiterentwicklung im HA-Projekt

Zigbee2MQTT bietet:

  • sehr große Geräteunterstützung
  • extrem viele Einstellmöglichkeiten
  • detailliertes Logging und Debugging
    → ideal für Power-User, die MQTT nicht scheuen.

deCONZ/Phoscon:

  • eigene Oberfläche für Geräteverwaltung
  • gute Backup-/Migrationsfunktionen
  • eng verknüpft mit ConBee-Hardware
    → interessant, wenn du das Ökosystem ohnehin nutzt oder migrieren möchtest.

Für die meisten Nutzer ist ZHA ein hervorragender Einstieg, weil es schnell zu einem funktionierenden Setup führt – ohne Zusatzdienste.


FAQ: Zigbee und ZHA in Home Assistant

Müssen Zigbee-Router gepairt werden?

Ja. Router wie Zigbee-Steckdosen, Repeater oder Lampen müssen zuerst in ZHA gekoppelt werden. Erst danach können sie als Router im Mesh für andere Geräte fungieren.

Wie viele Router brauche ich am Anfang?

Für kleine bis mittlere Wohnungen reicht oft ein Start mit 1 Koordinator und 2 Routern. In verwinkelten Grundrissen, über mehrere Etagen oder bei vielen Wänden sind zusätzliche Router meist schneller wirksam als ein Koordinator-Wechsel.

Was ist für Einsteiger besser: ZHA oder Zigbee2MQTT?

In den meisten Fällen ist ZHA der einfachere Einstieg, weil es direkt in Home Assistant integriert ist. Zigbee2MQTT ist sinnvoll, wenn du bewusst mehr Tuning-Optionen, detailliertes Debugging und MQTT-Workflows nutzen willst.

Fazit: So startest du stabil mit Zigbee und ZHA

Der Einstieg in die Welt von Zigbee wirkt anfangs komplex, aber mit der richtigen Hardware und ZHA als Integration ist der Weg überraschend gerade:

  • Wähle einen soliden Koordinator (z. B. SMLIGHT SLZB-06M oder Sonoff ZBDongle-E).
  • Ergänze dein Setup um Router-Geräte, damit das Mesh stabil wird.
  • Nutze ZHA für einen unkomplizierten Start direkt in Home Assistant.
  • Wachse von dort Schritt für Schritt – mehr Geräte, mehr Automatisierungen, ggf. später andere Integrationen.

Mit den hier beschriebenen Schritten und Empfehlungen legst du den Grundstein für ein stabiles Zigbee-Netzwerk. Egal, ob du gerade erst beginnst oder dein bestehendes Smart Home ausbauen möchtest – ZHA bietet dir einen einfachen und gleichzeitig mächtigen Einstiegspunkt in die Zigbee-Welt.

Erstellt mit Hugo
Theme Stack gestaltet von Jimmy