ZigDash

Bytte fra ZHA til Zigbee2MQTT

ZHA er Home Assistants egen Zigbee. ZigDash fungerer med Zigbee2MQTT, så den kan ikke vise enheter som ligger i ZHA. Å bytte betyr å pare enhetene på nytt med Zigbee2MQTT. Home Assistant fortsetter å bruke dem etterpå, via MQTT-integrasjonen.

Før du begynner

To måter å bytte på

Ekstra adapterSamme adapter
KostnadEn ny adapter, ca. 30–60 euro (for eksempel en Home Assistant Connect ZBT-2, eller en SMLIGHT SLZB-06M eller SLZB-07)Gratis
Mens du bytterAlt fortsetter å virke: ZHA beholder den gamle adapterenZigbee er av til hver enhet er paret på nytt
TempoRom for rom, gjerne over flere dagerAlt på én gang
Gå tilbakeEnkelt: trekk ut den nye adapteren, ZHA stoppet aldriGjenopprett ZHA-sikkerhetskopien (se Gå tilbake)

Ekstra adapter

  1. Sett opp Zigbee2MQTT på den nye adapteren (med apper eller Docker) med sitt eget nettverk. Velg alt dette før Zigbee2MQTT starter for første gang, for å bytte kanal senere kan bety at du må pare på nytt:
    • la nettverksnøkkelen og PAN ID stå på GENERATE (standard);
    • velg en annen kanal enn ZHA sin (ZHA sitt ⚙ › Network information viser den); Home Assistant anbefaler 15, 20 eller 25.
  2. Hold de to adapterne et stykke fra hverandre, hver på sin USB-skjøteledning.
  3. På Home Assistant OS kan Home Assistant tilby å sette opp den nye adapteren for ZHA eller Thread når du kobler den til. Ignorer det: adapteren er for Zigbee2MQTT.
  4. Flytt ett rom om gangen: par først enhetene med strøm fra stikkontakten (pærer, støpsler, innbygde brytere: de er rutere), deretter batterienhetene.
  5. Når alle enhetene er flyttet, deaktiverer du ZHA (se under) og beholder den gamle adapteren som reserve.

Samme adapter

  1. Last ned ZHA-sikkerhetskopien (se Før du begynner) rett før du starter.
  2. Deaktiver ZHA: Innstillinger › Enheter og tjenester › Zigbee Home Automation, ⋮ ved siden av Zigbee Home Automation › Disable. Ikke Delete.
  3. Sett opp Zigbee2MQTT på samme adapter (med apper eller Docker), og la nettverksnøkkelen og PAN ID stå på GENERATE.
  4. Slå av Zigbee-enhetene med strøm fra nettet, på veggen eller i sikringsskapet. Ellers fortsetter de å lete etter det gamle nettverket.
  5. Slå dem på igjen én etter én, og par hver enhet når den kommer på. Par deretter batterienhetene.

Adapteren din

Zigbee2MQTT sine adaptersider har detaljene.

Home Assistant med apper (Home Assistant OS)

  1. I Innstillinger › Apps installerer og starter du Mosquitto broker. Home Assistant tilbyr deretter MQTT-integrasjonen under Innstillinger › Enheter og tjenester: godta den.
  2. Legg til Zigbee2MQTT-repositoriet (i appbutikken, ⋮ › Repositories: https://github.com/zigbee2mqtt/hassio-zigbee2mqtt), og installer deretter Zigbee2MQTT.
  3. I fanen Configuration setter du serieporten og adapteren ut fra adapteren din, for eksempel:
    port: /dev/serial/by-id/usb-...
    adapter: ember
    For måten med ekstra adapter setter du også kanalen (se over) før første start.
  4. Start Zigbee2MQTT og åpne nettsiden fra appens side. Deretter parer du.

Home Assistant i Docker (uten apper)

Uten apper kjører Mosquitto og Zigbee2MQTT som egne containere ved siden av Home Assistant. I en ny mappe:

1. compose.yaml (sett stien til adapteren i devices; ls /dev/serial/by-id/ viser den):

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

Med en nettverksadapter utelater du devices og udev-linjen.

2. mosquitto/config/mosquitto.conf:

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

Opprett MQTT-brukeren (du blir bedt om passordet to ganger; filen må eies av Mosquittos egen bruker, ellers starter ikke Mosquitto):

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 (adapterlinjene fra adapteren din):

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. Med samme adapter er ZHA nå deaktivert (se over). Hvis Home Assistants egen container har adapteren koblet inn, fjerner du den linjen fra compose-filen eller docker run: bare én container kan bruke adapteren.

5. docker compose up -d, og åpne deretter http://the-machine:8080: nettsiden til Zigbee2MQTT.

6. I Home Assistant: Innstillinger › Enheter og tjenester › Add integration › MQTT. Broker: maskinens IP-adresse, port 1883, bruker zigbee og passordet.

Pare enhetene

  1. På nettsiden til Zigbee2MQTT trykker du på Permit join (åpent i omtrent fire minutter). For å pare via en ruter nær enheten velger du den ruteren i permit join-menyen: nyttig for Aqara og andre kresne enheter.
  2. Sett enheten i paremodus slik produsenten beskriver: et langt trykk for de fleste sensorer, noen av/på-runder for pærer, en serie bryterklikk for enkelte innbygde brytere.
  3. Når den dukker opp, gir du den navn og rom i Zigbee2MQTT. Så den neste.

Enheter med strøm fra nettet først, batterienheter etterpå, slik at det nye nettverket har veier å sende signalene gjennom.

Etter byttet

Gå tilbake

Testet: 17. november 2026, med Home Assistant 2026.11 og en Sonoff ZBDongle-E, kom ZHA-nettverket tilbake helt likt (kanal, PAN ID og nettverksnøkkel). Vi har ikke testet det med parede enheter ennå, så ta vare på sikkerhetskopifilen.

Beholde nettverket uten å pare på nytt

Det finnes en tredje måte: å kopiere ZHA-nettverket inn i Zigbee2MQTT, slik at enhetene ikke må pares på nytt. Zigbee2MQTT støtter det ikke, en feil verdi kan slette nettverket, og det gir bare mening for store hjem (for eksempel over 60 enheter). Vil du lese om det: svaret fra vedlikeholderen av Zigbee2MQTT, og erfaringer fra brukere i diskusjon 24478 og diskusjon 26716.

Fortell oss hvordan det gikk. Denne veiledningen er ny. Hvis et steg var feil eller manglet, skriv til [email protected] eller fellesskapet.