Je Zigbee2MQTT apparaten staan ineens offline in Home Assistant, en niet één maar een hele reeks tegelijk. Opnieuw koppelen voelt logisch, maar is zelden de eerste stap. Bij massale uitval kan de oorzaak in een gedeelde laag zitten, en dat hoeft het Zigbee-netwerk zelf niet te zijn.
Voor wie is dit? Voor iedereen met Zigbee2MQTT en een MQTT-broker bij wie meerdere apparaten tegelijk wegvallen. Meldt zich maar één apparaat niet, kijk dan naar de batterij of het bereik. Dit artikel helpt je dan niet verder.
📋 Inhoud van dit artikel
Zigbee2MQTT apparaten offline: waarom Zigbee niet altijd de boosdoener is
Tussen je sensor en je dashboard zit een keten. Het apparaat praat met de coordinator, de Zigbee-adapter van je server (meestal een USB-stick, soms een netwerkadapter). Zigbee2MQTT vertaalt dat naar MQTT-berichten. Een MQTT-broker, meestal Mosquitto, bezorgt ze. De MQTT-integratie van Home Assistant maakt er entiteiten van.
Valt een van die schakels uit, dan ziet het er in Home Assistant hetzelfde uit: entiteiten die niet beschikbaar zijn. Daardoor kan een broker die niet bereikbaar is aanvoelen als een kapot Zigbee-netwerk.
Eén apparaat dat wegvalt wijst eerder op dat apparaat zelf. Veel apparaten tegelijk wijzen op een gedeelde laag. Het bewijst niet welke: een vastgelopen Zigbee2MQTT of een losse USB-stick geeft hetzelfde beeld als een broker die niet bereikbaar is.
Zigbee2MQTT apparaten offline: diagnose in 4 stappen
Kopieer eerst de recente log van Zigbee2MQTT naar een tekstbestand. Dat kost een minuut en je hoeft later niet te raden wat er gebeurde. Noteer ook de tijd waarop het misging.
Stap 1: één apparaat of het hele netwerk?
Open de apparatenlijst in de Zigbee2MQTT-interface. Zit er één apparaat tussen dat zich al dagen niet meldt? Kijk dan naar de batterij, de afstand en of er een router in de buurt is. Een router is een Zigbee-apparaat op netstroom dat het signaal doorgeeft. Dan is dit artikel niet je pad.
Staan er meerdere apparaten tegelijk op offline of niet beschikbaar, ga dan door. Hoeveel is veel? Daar bestaat geen vaste grens voor. Bij mij is vijf tegelijk de drempel, maar dat is een keuze voor mijn eigen netwerk van 32 apparaten.
Stap 2: draait Zigbee2MQTT en is de broker bereikbaar?
Kijk of de add-on of container van Zigbee2MQTT draait en of de interface reageert. Luister daarna zelf mee op de broker. In Home Assistant ga je naar Instellingen, Apparaten en diensten, open je de MQTT-integratie (of Mosquitto broker) en kies je Configureren. Daar vind je het veld om naar een topic te luisteren, in het Engels "Listen to a topic". Vul zigbee2mqtt/bridge/state in.
Stap 3: wat zeggen de logs?
De documentatie van Zigbee2MQTT noemt Not connected to MQTT server! als teken dat Zigbee2MQTT de MQTT-server niet kan bereiken. Dat zegt wat er stuk is, niet waarom. Meldingen over de adapter of de seriële poort wijzen juist naar de coordinator en dus naar een andere laag.
Mijn eigen storingen begonnen met MQTT error: read ECONNRESET en later Not connected to MQTT server!. Zo'n regel zegt nog niets over de oorzaak. Bewaar hem met de tijd erbij.
Stap 4: komt er nieuwe data binnen?
Hier gaat het vaak mis, omdat drie dingen op elkaar lijken maar niet hetzelfde zijn:
- Een bewaard bericht is de laatste status die de broker onthoudt en aan nieuwe luisteraars geeft.
- Availability is een statuscheck met een ingestelde timeout.
- Verse data is een bericht dat recent is aangekomen.
Luister naar het topic van een apparaat dat vaak meldt, zoals een slimme stekker met vermogensmeting (zigbee2mqtt/naam-van-je-apparaat), en kijk of er na het starten nog nieuwe berichten bijkomen. Eén bericht direct bij het starten kan het bewaarde bericht zijn. Geen nieuw bericht in een paar seconden bewijst ook niets: sensoren melden vaak alleen bij een verandering of na een ingesteld interval.
Gebruik ook de tijdstempel in Home Assistant niet als enige test. Bij MQTT-entiteiten schrijft Home Assistant meestal alleen een nieuwe status als de waarde verandert. Een sensor die niets meer meldt ziet er dan hetzelfde uit als een sensor waarvan de waarde gewoon gelijk blijft.
Over availability: dat staat in Zigbee2MQTT standaard uit. Zet je het aan, dan krijgen actieve apparaten volgens de documentatie (gecontroleerd op 8 oktober 2026) standaard 10 minuten om zich te melden, daarna volgt een ping. Mislukt die, dan staat het apparaat offline. Passieve batterijapparaten kun je niet pingen, die krijgen standaard 25 uur. Ik heb die timeout bij mij op 240 minuten gezet. Ga niet te ver naar beneden, want sommige batterijapparaten melden zich zelden. Controleer de waarden in je eigen installatie.
Samengevat in een tabel:
| Wat je ziet | Waar het waarschijnlijk zit | Eerste stap |
|---|---|---|
| Eén apparaat offline | Het apparaat zelf: batterij, afstand of een router die ontbreekt | Dat apparaat nalopen. Dit artikel is dan niet het juiste pad. |
| Meerdere apparaten offline, Zigbee2MQTT start niet of geeft adapterfouten | Zigbee2MQTT of de coordinator | De startfouten in de log lezen en de seriële poort en de adapter controleren. |
Log meldt Not connected to MQTT server! | De verbinding tussen Zigbee2MQTT en de broker | Broker en netwerk controleren. Nog niets opnieuw koppelen. |
| Berichten komen wel binnen op de broker, maar Home Assistant toont ze niet | De kant van Home Assistant: discovery, MQTT-integratie of availability | De MQTT-integratie en de Home Assistant-log nalopen. |
| Alles werkt weer, één apparaat blijft stil | Het apparaat of zijn rapportage-instellingen | Modelspecifiek herconfigureren of wakker maken. Pas daarna opnieuw koppelen. |
Praktijkvoorbeeld: een valse Zigbee-storing bij mij thuis
Op 14 september 2026 viel om 06:53 alles weg wat bij mij via MQTT praat. Zigbee2MQTT meldde MQTT error: read ECONNRESET en kwam twee uur lang niet terug. In de interface leek het alsof heel Zigbee kapot was. Ook het board van mijn CV, dat via MQTT werkt, was onbereikbaar.
Mijn eerste gedachte was een signaalprobleem. De netwerkkaart liet iets anders zien: van de 32 apparaten hadden er 29 een LQI (signaalkwaliteit) tussen 100 en 255. Dat wees niet op een zwak Zigbee-netwerk, al is LQI maar een grove indicator. Wat de ECONNRESET veroorzaakte, weet ik niet.
Mijn automatische herstart deed niets, omdat hij wachtte op de status off. De entiteit ging naar unavailable. Controleer dus waar je automatiseringen precies op triggeren.
heatOnSensorFail) en bleef daardoor blind doorstoken. Sindsdien loopt die noodstop via een route buiten MQTT om. Die extra route is een aanvulling en geen vervanging van de beveiligingen van de ketel zelf. Laat een veiligheidsfunctie nooit afhangen van dezelfde keten die kan uitvallen.
Op 25 september gebeurde het opnieuw. Zigbee2MQTT praatte prima met de apparaten, maar kon niets publiceren (Not connected to MQTT server!). In Home Assistant stond de verbindingssensor van de bridge gewoon op on. Die sensor draait op een bewaard MQTT-bericht, dus hij gaf een misleidend beeld. Mijn twee vangnetten keken naar precies die sensor en gingen daarom niet af.
Dit keer lag het aan mijzelf. Ik had een herstelstap toegevoegd die de MQTT-integratie herlaadt. Daardoor raakte Zigbee2MQTT zijn verbinding kwijt en kwam er zelf niet meer uit. Die stap heb ik verwijderd. Dit is wat er in mijn installatie gebeurde (toen Home Assistant 2026.9.3). Het bewijst niet dat herladen in elke installatie hetzelfde probleem geeft.
Veilig herstellen zonder te herkoppelen
Herstart niet standaard achter elkaar de broker, Zigbee2MQTT en Home Assistant. Dat verdoezelt de oorzaak. Doe dit in plaats daarvan:
Bewaar eerst bewijs
Kopieer de logs, noteer het tijdstip en de versies van Home Assistant, Zigbee2MQTT en de broker.
Herstel alleen de laag waarvoor je aanwijzingen hebt
Meldt de log een verbindingsfout, kijk dan naar de broker en het netwerk. Meldt hij een adapterfout, kijk dan naar de coordinator.
Controleer na elke wijziging of er verse data terugkomt
Gebruik de test uit stap 4. Komt er verse data terug, dan is het gelukt. Komt die niet, ga dan pas naar de volgende laag.
Blijft daarna één apparaat stil, dan komt opnieuw koppelen pas in beeld. Kijk eerst of het model herconfigureren ondersteunt. De documentatie meldt dat niet elk apparaat dat kan en dat een batterijapparaat soms eerst wakker moet worden gemaakt.
Preventie: zorg dat je het merkt
Je kunt niet voorkomen dat er ooit iets uitvalt. Je kunt wel zorgen dat je het snel weet in plaats van na twee dagen:
- Zet availability bewust aan met timeouts die bij je apparaten passen, en noteer wat je hebt ingesteld.
- Laat een melding afgaan bij meerdere onbereikbare apparaten tegelijk, en trigger op
unavailable, niet alleen opoff. Vertrouw niet op de bridge-sensor alleen. - Noteer je versies van Home Assistant, Zigbee2MQTT, de broker en de coordinatorfirmware, zodat je bij een storing kunt vergelijken wat er veranderd is.
Zelf laat ik bij vijf of meer apparaten tegelijk de add-on herstarten, hooguit eens per halfuur. Dat is mijn eigen keuze en geen advies voor iedereen. Begin zelf met alleen een melding.
Wil je zien hoe je Home Assistant slim inzet voor je energierekening? Lees dan mijn uitleg over energie-automatiseringen in Home Assistant. Haal je je P1-gegevens via MQTT binnen, dan valt die data ook weg bij een MQTT-storing. De officiële HomeWizard-integratie in Home Assistant leest de meter lokaal uit via de eigen API van het apparaat, dus die loopt niet via Zigbee2MQTT. Hoe je dat opzet staat bij P1-meter koppelen aan Home Assistant. Meer over Zigbee, WiFi en Matter vind je in de uitleg over smarthome-protocollen.
💡 Volgende stap
Wil je Home Assistant gebruiken om energie te besparen, zonder dat het je verwarming raakt? Begin klein en bouw rustig uit.
Naar de energie-automatiseringen →Veelgestelde vragen over Zigbee2MQTT storingen
Moet ik mijn Zigbee-apparaten opnieuw koppelen als ze offline staan?
Niet als eerste stap. Controleer eerst of de hele keten werkt: Zigbee2MQTT, de MQTT-broker en de verbinding met Home Assistant. Meldt één apparaat zich daarna nog steeds niet, kijk dan eerst naar modelspecifieke opties zoals herconfigureren of het apparaat wakker maken. Pas daarna is opnieuw koppelen te overwegen.
Waarom staat Zigbee2MQTT op online terwijl mijn sensoren niet updaten?
Zigbee2MQTT bewaart zijn bridge-status als retained bericht op de broker. Dat bericht krijg je direct te zien zodra je meeluistert, ook als Zigbee2MQTT intussen geen nieuwe berichten meer publiceert. Luister daarom naar het topic van een apparaat dat vaak meldt en kijk of er nieuwe berichten bijkomen.
Wat is het verschil tussen availability en verse data?
Availability is een statuscheck met een ingestelde timeout. Verse data betekent dat er recent een nieuw bericht is aangekomen. Een sensor waarvan de waarde niet verandert, is ook geen bewijs dat hij is uitgevallen, want veel apparaten melden alleen bij een verandering of na een ingesteld interval.
Waarom gaan batterijapparaten niet snel offline?
Availability staat in Zigbee2MQTT standaard uit. Staat het aan, dan gelden volgens de documentatie (gecontroleerd op 8 oktober 2026) standaard 10 minuten voor actieve apparaten op netstroom en 25 uur voor passieve batterijapparaten. Passieve apparaten kunnen niet worden gepingd. Controleer de waarden in je eigen installatie.
Hoeveel apparaten moeten tegelijk offline zijn voordat ik aan de keten denk?
Daar is geen vaste grens voor. Meerdere apparaten tegelijk is een aanwijzing voor een gedeelde oorzaak, geen bewijs. Zelf grijp ik in bij vijf of meer apparaten tegelijk, maar dat is een keuze voor mijn eigen netwerk van 32 apparaten.
Mag ik Zigbee2MQTT automatisch laten herstarten bij uitval?
Liever niet blind. Een herstartlus kan de oorzaak verbergen en je krijgt geen idee meer wat er mis ging. Begin met een melding en bewaar de logs. Kies je toch voor een automatische herstart, beperk die dan tot weinig pogingen, bijvoorbeeld één per halfuur zoals ik doe, en test hem voordat je erop vertrouwt.
Bronnen (gecontroleerd op 8 oktober 2026): Device Availability, Zigbee2MQTT · MQTT Topics and Messages, Zigbee2MQTT · FAQ, Zigbee2MQTT · Zigbee2MQTT fails to start/crashes runtime · MQTT, Home Assistant · State and state object, Home Assistant · HomeWizard, Home Assistant