ZigDash

Byta från ZHA till Zigbee2MQTT

ZHA är Home Assistants egen Zigbee. ZigDash fungerar med Zigbee2MQTT, så den kan inte visa enheter som ligger i ZHA. Att byta innebär att du parkopplar dina enheter igen med Zigbee2MQTT. Home Assistant fortsätter att använda dem efteråt, via sin MQTT-integration.

Innan du börjar

Två sätt att byta

Extra adapterSamma adapter
KostnadEn ny adapter, cirka 30–60 euro (till exempel en Home Assistant Connect ZBT-2, eller en SMLIGHT SLZB-06M eller SLZB-07)Gratis
Medan du byterAllt fortsätter att fungera: ZHA behåller den gamla adapternZigbee är avstängt tills varje enhet är parkopplad igen
TaktRum för rum, gärna under flera dagarAllt på en gång
Gå tillbakaEnkelt: dra ur den nya adaptern, ZHA stoppade aldrigÅterställ ZHA-säkerhetskopian (se Gå tillbaka)

Extra adapter

  1. Sätt upp Zigbee2MQTT på den nya adaptern (med appar eller Docker) med ett eget nätverk. Välj allt detta innan Zigbee2MQTT startar första gången, eftersom ett kanalbyte senare kan innebära att du måste parkoppla igen:
    • låt nätverksnyckeln och PAN ID stå på GENERATE (standard);
    • välj en annan kanal än ZHA:s (ZHA:s ⚙ › Network information visar den); Home Assistant rekommenderar 15, 20 eller 25.
  2. Håll de två adaptrarna isär, var och en på sin USB-förlängningskabel.
  3. På Home Assistant OS kan Home Assistant erbjuda sig att sätta upp den nya adaptern för ZHA eller Thread när du kopplar in den. Strunta i det: adaptern är till för Zigbee2MQTT.
  4. Flytta ett rum i taget: parkoppla först rummets nätdrivna enheter (lampor, uttag, infällda strömbrytare: de är routrar), sedan de batteridrivna.
  5. När alla enheter är flyttade inaktiverar du ZHA (se nedan) och sparar den gamla adaptern som reserv.

Samma adapter

  1. Ladda ner ZHA-säkerhetskopian (se Innan du börjar) precis innan du börjar.
  2. Inaktivera ZHA: Inställningar › Enheter och tjänster › Zigbee Home Automation, ⋮ bredvid Zigbee Home Automation › Disable. Inte Delete.
  3. Sätt upp Zigbee2MQTT på samma adapter (med appar eller Docker) och låt nätverksnyckeln och PAN ID stå på GENERATE.
  4. Stäng av dina nätdrivna Zigbee-enheter med väggbrytaren eller i proppskåpet. Annars fortsätter de att leta efter det gamla nätverket.
  5. Slå på dem igen en i taget och parkoppla var och en när den startar. Parkoppla sedan de batteridrivna enheterna.

Din adapter

Zigbee2MQTT:s adaptersidor har detaljerna.

Home Assistant med appar (Home Assistant OS)

  1. Under Inställningar › Apps installerar och startar du Mosquitto broker. Home Assistant erbjuder sedan MQTT-integrationen under Inställningar › Enheter och tjänster: godkänn den.
  2. Lägg till Zigbee2MQTT-förrådet (i appbutiken, ⋮ › Repositories: https://github.com/zigbee2mqtt/hassio-zigbee2mqtt) och installera sedan Zigbee2MQTT.
  3. På fliken Configuration anger du serieporten och adaptern utifrån din adapter, till exempel:
    port: /dev/serial/by-id/usb-...
    adapter: ember
    För sättet med extra adapter anger du också kanalen (se ovan) före första starten.
  4. Starta Zigbee2MQTT och öppna dess webbsida från appens sida. Sedan parkopplar du.

Home Assistant i Docker (utan appar)

Utan appar körs Mosquitto och Zigbee2MQTT som egna containrar bredvid Home Assistant. I en ny mapp:

1. compose.yaml (ange sökvägen till din adapter i devices; ls /dev/serial/by-id/ visar 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 nätverksadapter utelämnar du devices och udev-raden.

2. mosquitto/config/mosquitto.conf:

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

Skapa MQTT-användaren (du får ange ett lösenord två gånger; filen måste ägas av Mosquittos egen användare, annars startar inte 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 (adapterraderna från din adapter):

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 samma adapter är ZHA nu inaktiverat (se ovan). Om Home Assistants egen container mappar adaptern tar du bort den raden från dess compose-fil eller docker run: bara en container i taget kan använda adaptern.

5. docker compose up -d, öppna sedan http://the-machine:8080: Zigbee2MQTT:s webbsida.

6. I Home Assistant: Inställningar › Enheter och tjänster › Add integration › MQTT. Broker: datorns IP-adress, port 1883, användare zigbee och lösenordet.

Parkoppla enheterna

  1. På Zigbee2MQTT:s webbsida trycker du på Permit join (öppet i ungefär fyra minuter). Vill du parkoppla via en router nära enheten väljer du den routern i permit join-menyn: praktiskt för Aqara och andra kräsna enheter.
  2. Sätt enheten i parkopplingsläge på det sätt tillverkaren anger: ett långt tryck för de flesta sensorer, några av/på-cykler för lampor, en serie brytarslag för vissa infällda strömbrytare.
  3. När den dyker upp ger du den namn och rum i Zigbee2MQTT. Sedan nästa.

Nätdrivna enheter först, batteridrivna efter, så att det nya nätverket har vägar att gå.

Efter bytet

Gå tillbaka

Testat: den 17 november 2026, med Home Assistant 2026.11 och en Sonoff ZBDongle-E, kom ZHA:s nätverk tillbaka exakt (kanal, PAN ID och nätverksnyckel). Vi har ännu inte testat det med parkopplade enheter, så spara säkerhetskopian.

Behålla nätverket utan att parkoppla igen

Det finns ett tredje sätt: att kopiera ZHA:s nätverk till Zigbee2MQTT så att enheterna inte behöver parkopplas igen. Zigbee2MQTT stöder det inte, ett felaktigt värde kan radera nätverket, och det är bara rimligt för stora hem (säg, över 60 enheter). Om du vill läsa om det: svaret från Zigbee2MQTT:s utvecklare, och erfarenheter från användare i diskussion 24478 och diskussion 26716.

Berätta hur det gick. Den här guiden är ny. Om ett steg var fel eller saknades, skriv till [email protected] eller communityn.