Si vous me lisez régulièrement, vous connaissez mon point de vue vis à vis des mises à jour. Je ne le répèterai jamais assez mais mettre à jour un système informatique en production représente toujours un risque. Encore plus quand il s’agit d’une version majeure, mais même les mises à jour mineures sont à considérer dans leur ensemble pour éviter tout ennui.
Depuis de nombreuses semaines la communauté derrière Zigbee2MQTT parle de cette mise à jour. Les développeurs avaient même introduit des préparatifs à cette montée de version majeure dans les précédentes release, de sorte à essayer tant bien que mal de préparer le terrain et réduire les risques.
Libéré il y a maintenant deux semaines, Zigbee2MQTT passe en version 2 avec pas mal de changements au programme. Une mise à jour majeure se matérialise par le premier chiffre de version qui se voit incrémenter. Ici, Z2M passe d’une version 1.42.xx à une version 2.0.0, il s’agit donc d’une version majeure.
En règle générale, une mise à jour majeure d’un programme informatique induit un grand nombre de changements et bien souvent des changement assez profonds dans le code. C’est le cas pour cette nouvelle version de Zigbee2MQTT qui se dote d’un nombre impressionnant de changements, correctifs et améliorations, je vous invite à consulter la page du changelog pour en consulter l’intégralité.
C’est effectivement une mise à jour majeure qui apporte un grand nettoyage du code, la suppression de plusieurs bibliothèques héritées des versions précédentes, une modification importante au niveau du système de mise à jour OTA des périphériques enfants et pas mal d’autres changements significatifs qui peuvent avoir une incidence.
On peut mentionner par exemple des modifications dans les interactions avec le système domotique Home Assistant. Ces changements ont pour but d’améliorer l’expérience utilisateur et la prise en charge de Z2M par le système domotique, mais cela peut aussi générer quelques problèmes à la mise à jour.
On constate par exemple de nouvelles lignes de paramètres dans le fichier de configuration qui font référence au legacy (l’héritage), visant à aider l’utilisateur final à moduler une transition plus ou moins douce vers cette nouvelle version.
advanced:
homeassistant_legacy_entity_attributes: false
homeassistant_legacy_triggers: false
legacy_api: false
legacy_availability_payload: false
device_options:
legacy: false
N’effectuez pas la mise à jour en production pour le moment
Vous l’aurez compris, ces changements importants peuvent avoir une incidence sur le comportement de votre domotique et plus particulièrement de votre réseau Zigbee. Nombreux sont ceux qui ont essayé la mise à jour et ont vu leurs périphériques Zigbee dysfonctionner quand ce n’est pas Zigbee2MQTT lui-même qui ne redémarre tout simplement pas.
Ce n’est pas anormal, toute mise à jour d’importance comporte des risques. Même sur des systèmes pourtant rôder à cette mécanique. Il n’y a qu’à citer Microsoft par exemple qui actuellement a bien du mal à proposer une release 24H2 de Windows 11 qui ne cause pas de multiples erreurs dans les entreprises…
C’est pourquoi je vous recommande de rester patient face à la montée de version vers Zigbee2MQTT 2.0.x. Bien évidement, il est possible de s’y essayer mais en prenant toutes les précautions nécessaires.
Les bonnes pratiques à adopter face à cette mise à jour
Premier conseil qui coule de source, faites vos sauvegardes avant toute montée de version. De cette manière vous aurez une version stable et fonctionnelle sur laquelle revenir en cas de gros problème. Dans le cas de Zigbee2MQTT, effectuez principalement une sauvegarde des fichiers de configuration ainsi que de la base de donnée. Suivant le type d’installation, la méthode de sauvegarde diffère.
Sauvegarder Z2M sous Home Assistant
Que vous soyez encore sur une version 2024 ou que vous soyez passé à la dernière version de Home Assistant 2025 avec le nouveau mode de sauvegarde, le principe est le même. Depuis le menu paramètres/Système/Sauvegardes, vous avez la possibilité d’initier une sauvegarde partielle permettant de sauvegarder uniquement le module additionnel Zigbee2MQTT.
SI vous utilisez une version déportée de Zigbee2MQTT, vous devrez procéder à une sauvegarde manuelle de la configuration comme expliqué dans le guide suivant.
Comment sauvegarder et restaurer ZigBee2MQTT
Dans ce guide, nous allons vous expliquer comment sauvegarder la configuration de ZigBee2MQTT en vue d’une mise à jour ou d’une migration. En effet, toute mise à jour peut provoquer des problèmes et voir sa configuration et les périphériques associés…
Enfin, si vous utilisez la virtualisation Proxmox pour gérer Zigbee2MQTT, c’est encore plus simple, vous n’avez qu’à sauvegarder la VM ou le conteneur LXC et/ou faire un snapshot. Là aussi je vous explique comment faire dans un guide pas à pas.
Maîtrisez les sauvegardes Proxmox : Guide pour choisir et appliquer la meilleure option, locale ou distante
Nous avons vu dans un premier guide sur la série Proxmox, comment installer le système de virtualisation libre, ainsi que l’installation simple et rapide de la domotique Home Assistant sous une machine virtuelle. Il convient ensuite de commencer à se…
Restez sous la version 1.42.0-2 si tout fonctionne bien pour le moment
La mise à jour vers la nouvelle version 2.0.x de Zigbee2MQTT devrait se faire dans un premier temps dans un espace de test pour voir les quelques incidences que cela peut avoir chez vous avant d’envisager la montée de version en production. Pour rappel, la dernière version stable avant cette v2 est la v1.42.0-2. Je vous invite à rester sous cette version si tout fonctionne bien pour vous et que votre réseau Zigbee est stable. Pourquoi chercher à monter en version et s’attirer des problèmes si tout fonctionne à merveille.
Patience et tests en série
Pour moi, il n’y a pas d’urgence à se précipiter sur cette version, nombreux sont ceux qui s’y sont essayés et ont dû faire machine arrière avec plus ou moins de problèmes. D’autres ont sauté le pas et n’ont pas rencontré de problèmes ou très peu… Mais encore une fois, toutes les installations sont différentes, le contexte, l’écosystème et toutes les interactions et configurations que vous avez dans votre système domotique, sont autant d’éléments qui peuvent subir les conséquences d’une telle MAJ.
Cela dépend également du nombre de périphériques Zigbee que vous avez dans votre installation et de la complexité de cette dernière. Un réseau Zigbee avec moins de 10 périphériques peut facilement se remonter de zéro en cas de problème. Une installation avec une centaine de périphériques Zigbee peut en revanche devenir un cauchemar à refaire, c’est aussi à considérer. Et puis il faut également prévoir un peu de temps au cas où pour disposer de suffisamment de temps pour remettre les choses en ordre si cela se passe mal.
La prudence est donc de mise, mieux vaut patienter un peu et laisser les experts tester cette nouvelle version, voir quelques correctifs et améliorations apportés avant de sauter le pas. Il y a d’ailleurs déjà une nouvelle version disponible la v2.0.0-2 qui apporte la correction d’un problème avec le port série du Raspberry pi 4.
Personnellement, j’ai plusieurs Zigbee2MQTT à la maison, mes instances en production restent sous des versions inférieures à la 2.0.0, car cela fonctionne très bien ainsi pour le moment avec une grande stabilité alors pourquoi venir casser ce qui fonctionne. J’ai sur mon lab une instance sous Zigbee2MQTT 2.0.0 sur laquelle j’ai commencé à jouer un peu, mais à vrai dire, je manque un peu de temps pour pousser les tests.
Vous avez été nombreux à me contacter suite à la mise à jour et votre Zigbee2MQTT qui tombe en carafe, il me semblait donc utile et important de faire ce petit article pour vous donner mes quelques conseils et astuces autour de cette mise à jour. N’hésitez pas à nous dire dans les commentaires si vous avez effectué la MAJ et si vous avez rencontré des problèmes ou si au contraire tout s’est bien passé.
Bonjour,
Je suis sous HA 2025.1.3. J’ai fait la MAJ MQTT 2.0 sans trop faire attention. Tout semble fonctionner correctement à l’exception de blueprint avec mes télécommandes IKEA agissant sur de l’éclairage. Ils sont devenus inopérants. J’ai une sauvegarde 1.42 si besoin. J’hésite à revenir en arrière pour l’instant. Merci pour votre article !
Finalement, je suis revenu en a la version 1.42…
Fait pour ma part, avec plus d’une centaine de périphérique Zigbee 🙂
Il faut juste bien avoir anticipé la partie télécommande avec HA, mais une fois fait tout roule.
Finalement le plus étonnant de cette nouvelle version, c’est la mise à jour possible de mes 6 détecteurs IKEA qui n’avait jamais vu une seule mise à jour 🙂
Bonjour,
Après la mise à jour en version 2.0.0, m2q refusait de se lancer à cause d’un problème dans le fichier de config. D’autant plus étonnant que je n’en utilise pas directement. En effet ma stack z2m/mosquitto/home-assistant tourne sur un cluster kubernetes avec des noeuds rpi4 et z2m est configuré à l’aide de variables d’env (c’est donc z2m qui se créé son fichier de config et qui comporte une erreur de syntaxe). Bref en passant sur l’image latest-dev en lieu et place de latest, tout refonctionne comme attendu.
Un grand merci pour ton travail.
Bonjour.
Pratiquement une centaine devices Zigbee et gros pb lors de l’install de la v2.0 (Z2MQTT refuse de démarrer avec message d’erreur dans la log sur la reconnaissance de l’adaptateur) .
Tout a été réglé avec juste l’ajout de 2 lignes dans le fichier conf
serial:
adapter: zstack
Un reboot et cela marche parfaitement
cdlt
La carte SD de mon RPI a lâché, et j’ai tout réinstallé en 2.0 (dans une VM Proxmox cette fois, avec ma clé zigbee ZZH en passthrough). J’ai peut être eu de la chance, mais à part quelques adaptations avec les convertisseurs externes, je n’ai rencontré aucun souci ni aucune difficulté