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-Einordnung, Router-Setup, Pairing und Troubleshooting.

Zigbee ist eine der praktischsten Funktechnologien für Home Assistant: geringer Energieverbrauch, breites Geräteangebot und ein Mesh-Netzwerk, das sich sauber erweitern lässt. Genau deshalb ist Zigbee für viele lokale Smart-Home-Setups der sinnvollste Einstieg.

Doch wie beginnt man konkret? Welche Hardware brauchst du wirklich, wie richtest du ZHA sauber ein, und welche Fehler tauchen am Anfang typischerweise auf? In diesem Beitrag zeige ich dir einen belastbaren Weg vom ersten Koordinator bis zum stabilen Grundsetup mit ZHA (Zigbee Home Automation).

Am Ende hast du nicht nur ein eingebundenes Zigbee-Netz, sondern auch ein besseres Gefühl dafür, warum manche Setups sofort stabil laufen und andere schon beim Pairing zickig werden.


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

Wenn du direkt loslegen willst und vor allem wissen möchtest, wie du ohne Umwege zu einem stabilen Start kommst, dann nutze diese Reihenfolge:

Ablauf für den schnellen Start (10 Minuten)

  1. Koordinator platzieren und mit dem Host verbinden
    Möglichst frei positionieren, nicht direkt neben WLAN-Router, USB-3-Hub oder Metallflächen. Bei USB-Sticks hilft oft schon eine kurze USB-Verlängerung.
  2. ZHA einrichten und Koordinator wählen
    In Home Assistant unter Geräte & Dienste die Integration „Zigbee Home Automation“ hinzufügen und den passenden Adapter auswählen. Netzwerk-Koordinatoren wie der SLZB-06M werden dabei anders angebunden als USB-Sticks.
  3. Router einbinden und pairen
    1-2 Router (z. B. Steckdosen oder Repeater) zuerst koppeln, damit direkt ein tragfähiges Grund-Mesh entsteht.
  4. Endgeräte pairen
    Danach Sensoren, Taster und andere batteriebetriebene Geräte hinzufügen.
  5. Kurzer Stabilitätscheck
    10-15 Minuten beobachten: kommen Zustandsänderungen sauber an, kannst du das Netz schrittweise erweitern.

Wenn du bei Schritt 5 schon Aussetzer siehst, nicht sofort alles neu aufsetzen. Meist helfen bessere Koordinator-Positionierung, ein zusätzlicher Router oder ein sauberer Abstand zu WLAN und USB-3-Störern.

Wenn du die Koordinator-Wahl ausführlicher einordnen willst, nutze den allgemeinen Vergleich: Zigbee-Koordinatoren für Home Assistant: Technischer Vergleich von Sonoff, ConBee III und SMLIGHT

Wenn du gezielt Sonoff-Modelle gegeneinander abwägen willst, ist der aktuelle Datenpunkt dieser Beitrag: Sonoff Zigbee Coordinator Benchmark for Home Assistant ZHA (EN)


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 und Aktoren, die Daten liefern oder Aktionen ausführen.
  4. Home Assistant + ZHA: die Software-Schicht für Verwaltung, Entitäten und Automationen.

Die vier Teile greifen direkt ineinander: Home Assistant schickt einen Befehl an den Koordinator, dieser verteilt ihn über das Mesh, 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. Stabilität kommt in der Praxis aus guter Platzierung, genug Routern und sauberer Kanalplanung.

Koordinator (Gateway)

Damit dieser Beitrag ein Einrichtungs-Guide bleibt, bekommst du hier bewusst nur die technische Einordnung. Die ausführlichen Tests und Hands-ons 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, etwa für Standortwechsel oder spätere Thread-Tests, lohnt sich ein Modell mit mehreren Betriebsmodi.

Für den Einstieg sind diese drei Richtungen am relevantesten:

Die maximale Netzgröße hängt in der Praxis stärker von Mesh-Qualität, Funkstörungen und Router-Verteilung ab als vom Koordinator allein. Eine realistische Startregel für viele Haushalte ist: 1 Koordinator + 2 bis 4 Router + 5 bis 20 Endgeräte.

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- oder Übergangsbereichen.

Entscheidend ist nicht nur die Anzahl, sondern die Verteilung:

  • Router entlang typischer Laufwege platzieren, etwa Flur, Treppenhaus oder Übergänge zwischen Etagen.
  • Nicht direkt neben WLAN-APs, USB-3-Hubs oder massiven Metallflächen positionieren.
  • Erst Router setzen, dann batteriebetriebene Endgeräte pairen, damit diese direkt gute Elternknoten finden.

Typische Router-Optionen für den Einstieg sind:

  • dedizierte Repeater wie ein Aeotec Range Extender Zi
  • Zigbee-Steckdosen mit Routing-Funktion wie NOUS A1Z oder Aqara Smart Plug
  • dauerhaft versorgte Lampen oder Aktoren, sofern sie an sinnvollen Stellen sitzen

Wenn du verstehen willst, warum ein zusätzliches Router-Gerät oft mehr bringt als ein Koordinator-Wechsel, ist das hier die passende Vertiefung: Zigbee-Routing-Mechanismen: Table Routing, Source Routing, Many-to-One & Broadcast Routing erklärt

Endgeräte

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

Für Einsteiger haben sich vor allem diese Klassen bewährt:

  • Temperatur- und Luftfeuchtigkeitssensoren
  • Bewegungsmelder
  • Tür- und Fensterkontakte
  • Funk-Taster für einfache Szenensteuerung

Ein paar konkrete Praxis-Einstiege aus dem Blog:

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

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

  1. Sensor kurz wecken 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.

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 laufen, bevor du mit der Zigbee-Einrichtung beginnst.

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

  • keine zusätzliche Software nötig
  • kein externer MQTT-Broker erforderlich
  • Integration, Geräteliste und Automationen 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- und Debugging-Features brauchst, kannst du immer noch auf Zigbee2MQTT oder deCONZ wechseln.

Zusätzliche Tools, die helfen:

  • eine Zigbee-Mesh-Karte zur Visualisierung des Netzes
  • SSH- oder Terminal-Zugriff auf Home Assistant für Debugging und 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-Sticks wie Sonoff oder ConBee idealerweise über ein USB-Verlängerungskabel an den Host anschließen.
    • LAN-/PoE-Geräte wie der SMLIGHT SLZB-06M im Netzwerk verbinden und bei Bedarf zunächst per Weboberfläche konfigurieren.
  2. Erkennung in Home Assistant prüfen
    Unter Einstellungen > System > Hardware prüfen, ob der Koordinator sichtbar ist. Bei USB-Sticks typischerweise als serielle Schnittstelle wie ttyUSB0, bei Netzwerk-Koordinatoren als erreichbarer Netzwerk-Endpunkt.

  3. ZHA-Integration hinzufügen

    • Einstellungen > Geräte & Dienste > Integration hinzufügen
    • „Zigbee Home Automation“ auswählen
    • passenden Koordinator-Typ wählen
    • bei USB den seriellen Adapter auswählen, bei Netzwerk-Koordinatoren die Socket-Adresse eintragen, z. B. socket://192.168.1.50:6638
    • Assistent abschließen

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

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, oft 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 und Raum zuweisen.

Gerade bei batteriebetriebenen Geräten kann es ein paar Sekunden dauern, bis alle Entitäten korrekt auftauchen. Hier lohnt Geduld deutlich mehr als hektisches Neu-Pairing.

Optimierung des Zigbee-Mesh-Netzwerks

Zigbee Mesh Topology

Nach dem Koppeln lohnt ein Blick auf die Netzwerktopologie, zum Beispiel über eine Zigbee Network Map:

  • Erreichbarkeit von Geräten prüfen
  • Router-Positionierung optimieren
  • Funk-Sackgassen vermeiden

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

  • ein zusätzlicher Router in der Nähe
  • den Koordinator höher, freier und zentraler zu platzieren
  • die WLAN-Kanalwahl zu prüfen, 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. Das kann mehrere Ursachen haben: Das Gerät ist zu weit vom Koordinator oder nächsten Router entfernt, der Pairing-Modus wurde nicht korrekt aktiviert oder das Gerät hängt noch in einem alten Netzwerk.

Lösung: Stelle sicher, dass sich das Gerät während des Pairings in der Nähe eines stabilen Knotens befindet. Lies die Anleitung des jeweiligen Geräts, um den Reset- und Pairing-Prozess sauber auszuführen. Wenn das Gerät nicht gefunden wird, einmal vollständig zurücksetzen und den Vorgang erneut starten. Auch ein Neustart von ZHA oder des Hosts kann in Einzelfällen helfen.

Instabilität des Netzwerks

Ein instabiles Zigbee-Netz zeigt sich oft durch sporadische Verbindungsabbrüche oder verzögerte Reaktionen. Diese Probleme treten häufig auf, wenn zu wenige Router vorhanden sind, der Koordinator ungünstig steht oder das 2,4-GHz-Band bereits durch WLAN stark belastet ist.

Lösung: Ergänze das Netz um ausreichend Router-Geräte wie Steckdosen oder Repeater, positioniere Koordinator und Router so, dass sie sich gegenseitig gut erreichen, und halte Abstand zu WLAN-Routern, dicken Metallgehäusen oder anderen Störquellen. Falls möglich, prüfe die Kanalwahl von Zigbee und WLAN gemeinsam statt isoliert.

Firmware-Updates und Kompatibilität

Manchmal sind Zigbee-Geräte aufgrund veralteter Firmware oder kleiner Inkompatibilitäten schwer in das Netzwerk zu integrieren. Einige Geräte funktionieren zwar grundsätzlich, verhalten sich aber unzuverlässig oder verlieren regelmäßig die Verbindung.

Hilfreiche Gegenmaßnahmen:

  • regelmäßig prüfen, ob es Firmware-Updates für Koordinator und kritische Router gibt
  • bei SMLIGHT Updates bequem über die Weboberfläche einspielen
  • bei Sonoff oder ConBee die Hersteller-Dokumentation und Community-Anleitungen nutzen
  • nach Updates Problemgeräte gezielt erneut testen statt das ganze Netz infrage zu stellen

Unerwartetes Verhalten von Geräten

Ein weiteres Problem sind Geräte, die scheinbar grundlos reagieren oder nicht auslösen. Dahinter stecken oft Fehlkonfigurationen in Automationen, ein ungünstiger Elternknoten oder unklare Gerätezustände direkt nach dem ersten Pairing.

Lösung: Prüfe Automationen und Szenen zunächst isoliert. Teste das Gerät mit einer einfachen Aktion, bevor du es in komplexe Automationen einbaust. Wenn nötig, pair das Gerät neu, damit es einen besseren Elternknoten bekommt. In komplexeren Setups helfen Logs, um die Ursache sauber einzugrenzen.


Empfehlungen für Einsteiger

Starte klein

Beginne mit:

  • 1 Koordinator
  • 1-2 Router-Geräten, etwa Steckdosen oder Repeatern
  • 2-5 Endgeräten wie Sensoren oder Schaltern

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

Wähle etablierte Geräte

Setze am Anfang eher auf Geräte, die:

  • von der Community gut dokumentiert sind
  • in ZHA oder Zigbee2MQTT sauber bekannt sind
  • Zigbee 3.0 unterstützen oder zumindest breit erprobt sind

Router bewusst platzieren

  • In Fluren, offenen Räumen und zentralen Punkten
  • Nicht hinter dicken Wänden oder in Metallregalen
  • Lieber ein oder 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
  • ein sauberes Grundsetup ohne MQTT-Overhead bevorzugst

Später kannst du immer noch zu Zigbee2MQTT oder deCONZ wechseln, wenn du merkst, dass dir bestimmte Funktionen 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 Home-Assistant-Projekt

Zigbee2MQTT bietet:

  • sehr große Geräteunterstützung
  • viele Einstell- und Tuning-Möglichkeiten
  • detaillierteres Logging und Debugging
    -> ideal für Nutzer, die MQTT bewusst einsetzen wollen

deCONZ/Phoscon bietet:

  • eigene Oberfläche für Geräteverwaltung
  • gute Backup- und Migrationsfunktionen
  • enge Verzahnung mit ConBee-Hardware
    -> interessant, wenn du dieses Ökosystem ohnehin nutzt oder gezielt darauf setzt

Für die meisten Nutzer ist ZHA der beste Einstieg, weil du schnell zu einem funktionierenden Setup kommst und dir in der Erstphase unnötige Komplexität sparst.

Wenn du die Integrationen ausführlicher gegeneinander abwägen willst: Zigbee2MQTT vs. ZHA: Der ultimative Vergleich für Home Assistant


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 Zigbee wirkt anfangs komplex, aber mit der richtigen Hardware und ZHA als Integration ist der Weg erstaunlich gerade:

  • Wähle einen soliden Koordinator, der zu deinem Einsatzort passt.
  • Ergänze dein Setup früh um Router-Geräte, damit das Mesh tragfähig wird.
  • Nutze ZHA für einen unkomplizierten Start direkt in Home Assistant.
  • Wachse von dort Schritt für Schritt: mehr Geräte, mehr Automationen, bei Bedarf 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 ist ein sauberer, lokaler und technisch vernünftiger Einstiegspunkt in die Zigbee-Welt.

Erstellt mit Hugo
Theme Stack gestaltet von Jimmy