ZigDash

Přechod ze ZHA na Zigbee2MQTT

ZHA je vlastní Zigbee v Home Assistantu. ZigDash pracuje se Zigbee2MQTT, takže nemůže zobrazit zařízení, která jsou v ZHA. Přechod znamená znovu spárovat zařízení se Zigbee2MQTT. Home Assistant je pak dál používá přes svou integraci MQTT.

Než začneš

Dva způsoby přechodu

Druhý adaptérStejný adaptér
CenaNový adaptér, asi 30–60 € (například Home Assistant Connect ZBT-2 nebo SMLIGHT SLZB-06M či SLZB-07)Zdarma
Během přechoduVšechno dál funguje: ZHA si nechává starý adaptérZigbee nefunguje, dokud každé zařízení znovu nespáruješ
TempoMístnost po místnosti, klidně i během několika dníVšechno najednou
Návrat zpětSnadný: odpoj nový adaptér, ZHA nikdy nepřestalo běžetObnov zálohu ZHA (viz Návrat zpět)

Druhý adaptér

  1. Nastav Zigbee2MQTT na novém adaptéru (s aplikacemi nebo Docker) s vlastní sítí. Tohle všechno zvol před prvním spuštěním Zigbee2MQTT, protože pozdější změna kanálu může znamenat nové párování:
    • síťový klíč a PAN ID nech na GENERATE (výchozí hodnota);
    • vyber jiný kanál, než má ZHA (ukáže ho ⚙ › Network information u ZHA); Home Assistant doporučuje 15, 20 nebo 25.
  2. Oba adaptéry drž od sebe, každý na USB prodlužovacím kabelu.
  3. V Home Assistant OS ti Home Assistant po připojení nového adaptéru může nabídnout jeho nastavení pro ZHA nebo Thread. Ignoruj to: adaptér je pro Zigbee2MQTT.
  4. Přesouvej jednu místnost po druhé: nejdřív spáruj zařízení napájená ze sítě (žárovky, zásuvky, vypínače ve zdi: jsou to routery), pak bateriová zařízení.
  5. Až přesuneš všechna zařízení, zakaž ZHA (postup níže) a starý adaptér si nech jako náhradní.

Stejný adaptér

  1. Stáhni zálohu ZHA (viz Než začneš) těsně předtím, než začneš.
  2. Zakaž ZHA: Nastavení › Zařízení a služby › Zigbee Home Automation, ⋮ vedle Zigbee Home Automation › Disable. Ne Delete.
  3. Nastav Zigbee2MQTT na stejném adaptéru (s aplikacemi nebo Docker), síťový klíč a PAN ID nech na GENERATE.
  4. Vypni zařízení Zigbee napájená ze sítě vypínačem na zdi nebo jističem. Jinak budou dál hledat starou síť.
  5. Zapínej je zpátky jedno po druhém a každé spáruj, jakmile naběhne. Pak spáruj bateriová zařízení.

Tvůj adaptér

Podrobnosti najdeš na stránkách o adaptérech Zigbee2MQTT.

Home Assistant s aplikacemi (Home Assistant OS)

  1. V Nastavení › Apps nainstaluj a spusť Mosquitto broker. Home Assistant pak nabídne integraci MQTT v Nastavení › Zařízení a služby: přijmi ji.
  2. Přidej repozitář Zigbee2MQTT (v obchodě s aplikacemi ⋮ › Repositories: https://github.com/zigbee2mqtt/hassio-zigbee2mqtt), pak nainstaluj Zigbee2MQTT.
  3. Na jeho kartě Configuration nastav sériový port a adaptér podle části Tvůj adaptér, například:
    port: /dev/serial/by-id/usb-...
    adapter: ember
    Při způsobu s druhým adaptérem nastav před prvním spuštěním i kanál (viz výše).
  4. Spusť Zigbee2MQTT a otevři jeho webovou stránku ze stránky aplikace. Pak přejdi k párování.

Home Assistant v Dockeru (bez aplikací)

Bez aplikací běží Mosquitto a Zigbee2MQTT jako samostatné kontejnery vedle Home Assistantu. V nové složce:

1. compose.yaml (do devices zadej cestu k adaptéru; ukáže ji ls /dev/serial/by-id/):

services:
  mosquitto:
    image: eclipse-mosquitto:2
    restart: unless-stopped
    ports:
      - 1883:1883
    volumes:
      - ./mosquitto/config:/mosquitto/config
      - ./mosquitto/data:/mosquitto/data
  zigbee2mqtt:
    image: ghcr.io/koenkk/zigbee2mqtt
    restart: unless-stopped
    depends_on:
      - mosquitto
    ports:
      - 8080:8080
    volumes:
      - ./zigbee2mqtt:/app/data
      - /run/udev:/run/udev:ro
    environment:
      - TZ=Europe/Berlin
    devices:
      - /dev/serial/by-id/usb-...:/dev/ttyACM0

Se síťovým adaptérem vynech devices a řádek s udev.

2. mosquitto/config/mosquitto.conf:

listener 1883
allow_anonymous false
password_file /mosquitto/config/passwd
persistence true
persistence_location /mosquitto/data/

Vytvoř uživatele MQTT (heslo se zadává dvakrát; soubor musí patřit vlastnímu uživateli Mosquitta, jinak se Mosquitto nespustí):

docker run -it --rm -v "$PWD/mosquitto/config:/mosquitto/config" eclipse-mosquitto:2 \
  sh -c "mosquitto_passwd -c /mosquitto/config/passwd zigbee && chown mosquitto:mosquitto /mosquitto/config/passwd"

3. zigbee2mqtt/configuration.yaml (řádky pro adaptér podle části Tvůj adaptér):

homeassistant:
  enabled: true
frontend:
  enabled: true
  port: 8080
mqtt:
  server: mqtt://mosquitto:1883
  user: zigbee
  password: your-password
serial:
  port: /dev/ttyACM0          # a network adapter: tcp://IP:6638
  adapter: ember
advanced:
  network_key: GENERATE
  pan_id: GENERATE
  ext_pan_id: GENERATE
  channel: 20                 # second adapter: not ZHA's channel

4. Při způsobu se stejným adaptérem je teď ZHA zakázané (viz výše). Pokud kontejner samotného Home Assistantu mapuje adaptér, odstraň ten řádek z jeho compose souboru nebo z docker run: adaptér může používat jen jeden kontejner.

5. docker compose up -d, pak otevři http://the-machine:8080: webovou stránku Zigbee2MQTT.

6. V Home Assistantu: Nastavení › Zařízení a služby › Přidat integraci › MQTT. Broker: IP adresa počítače, port 1883, uživatel zigbee a heslo.

Párování zařízení

  1. Na webové stránce Zigbee2MQTT klepni na Permit join (párování zůstane otevřené asi čtyři minuty). Chceš-li párovat přes router blízko zařízení, vyber ten router v nabídce permit join: hodí se to pro Aqara a jiná vybíravá zařízení.
  2. Přepni zařízení do režimu párování podle návodu výrobce: u většiny senzorů dlouhým stiskem, u žárovek několikerým vypnutím a zapnutím, u některých vypínačů ve zdi sérií přepnutí.
  3. Až se objeví, dej mu v Zigbee2MQTT jméno a místnost. Pak další.

Nejdřív zařízení napájená ze sítě, potom bateriová, aby nová síť měla trasy.

Po přechodu

Návrat zpět

Vyzkoušeno: 17. listopadu 2026 s Home Assistantem 2026.11 a adaptérem Sonoff ZBDongle-E se síť ZHA vrátila přesně (kanál, PAN ID i síťový klíč). Se spárovanými zařízeními jsme to zatím nezkoušeli, takže si soubor se zálohou nech.

Zachování sítě bez nového párování

Existuje i třetí způsob: zkopírovat síť ZHA do Zigbee2MQTT, aby zařízení nebylo nutné znovu párovat. Zigbee2MQTT ho nepodporuje, chybná hodnota může síť smazat a dává smysl jen u velkých domácností (řekněme nad 60 zařízení). Pokud si o tom chceš přečíst: odpověď správce Zigbee2MQTT a zkušenosti komunity v diskusi 24478 a diskusi 26716.

Dej nám vědět, jak to šlo. Tento návod je nový. Pokud byl nějaký krok špatně nebo chyběl, napiš na [email protected] nebo do komunity.