ZHA est l'intégration Zigbee intégrée à Home Assistant, construite sur la bibliothèque zigpy. Zigbee2MQTT est un programme séparé qui demande un broker MQTT comme Mosquitto. Les deux documentations indiquent qu'un appareil appairé à l'un doit être réinitialisé avant de rejoindre l'autre : changer plus tard, c'est réappairer chaque appareil.
- ZHA vit dans Home Assistant ; Zigbee2MQTT tourne à côté et demande un broker MQTT.
- Changer, c'est tout réappairer. Les deux projets exigent une réinitialisation avant de rejoindre l'autre.
- La migration de clé est une autre affaire, limitée à certaines familles de puces, au sein du même logiciel.
- Sauvegardez le coordinateur quel que soit votre choix : c'est ce qui permet de remplacer une clé morte sans réappairer.
La vraie différence, c'est où vit la pile
Les deux projets pilotent les mêmes clés Zigbee USB et réseau, et les deux sont open source. ZHA est une intégration du code même de Home Assistant ; sa documentation la décrit comme une « implémentation de passerelle Zigbee indépendante du matériel », reposant sur la bibliothèque zigpy. Zigbee2MQTT est un programme à part. Son guide de démarrage demande un broker MQTT avant toute chose, Mosquitto étant recommandé.
Cette seule différence décide de presque tout le reste. Avec ZHA, aucun service en plus, et les appareils apparaissent directement dans Home Assistant. Avec Zigbee2MQTT, chaque appareil devient un ensemble de sujets MQTT auxquels Home Assistant s'abonne, comme n'importe quel autre logiciel qui parle MQTT.
| ZHA | Zigbee2MQTT | |
|---|---|---|
| Tourne | Dans Home Assistant | Comme programme ou app séparé |
| Service en plus | Aucun | Un broker MQTT (Mosquitto recommandé) |
| Bibliothèque Zigbee | zigpy | zigbee-herdsman |
| Licence | Apache-2.0 (Home Assistant), zigpy GPL-3.0 | GPL-3.0 |
| Utilisable sans Home Assistant | Non | Oui, par tout client MQTT |
| Restauration de sauvegarde du coordinateur | Silicon Labs, TI, ConBee/RaspBee | TI (zstack) et Silicon Labs (ember) |
Comment choisir
Il n'y a pas de gagnant mesuré ici, et nous n'avons pas fait tourner les deux sur le même réseau pour ce guide. Voici le raisonnement que permet l'architecture.
- Choisissez ZHA si Home Assistant est, et restera, votre seul contrôleur, et que vous voulez le moins de pièces mobiles : pas de broker à sécuriser, mettre à jour ou sauvegarder.
- Choisissez Zigbee2MQTT si vous voulez que le réseau Zigbee survive à un changement de contrôleur, alimenter directement d'autres outils comme Node-RED via MQTT, ou qu'il continue de tourner pendant un redémarrage de Home Assistant, puisque c'est un processus séparé.
- Dans les deux cas, vérifiez vos appareils précis dans la documentation des appareils pris en charge de chaque projet avant de vous engager : c'est avec cela que vous vivrez.
Un broker MQTT est un service de plus, avec ses identifiants, ses mises à jour et ses pannes possibles. Le coût est faible et bien connu, mais c'est le vrai prix de la souplesse de Zigbee2MQTT : comptez-le.
Passer de l'un à l'autre
C'est la partie que les comparatifs sautent. Un appareil Zigbee n'appartient qu'à un réseau à la fois, et aucun des deux projets ne restaure le réseau de l'autre. Les deux documentations disent la même chose presque mot pour mot : un appareil déjà connecté à une autre implémentation Zigbee doit être remis aux réglages d'usine avant de pouvoir rejoindre.
- Inventoriez d'abord. Listez chaque appareil Zigbee et son emplacement, y compris ceux derrière les meubles. Les capteurs sur pile sont ceux qu'on oublie.
- Préparez les réinitialisations. Chaque appareil a sa méthode : un bouton maintenu quelques secondes, une séquence de coupures pour les ampoules, une pointe pour les capteurs. Cherchez-les avant le soir où vous commencez.
- Appairez d'abord les routeurs sur secteur. Prises et ampoules étendent le maillage ; les appairer en premier donne aux appareils sur pile un relais pour rejoindre.
- Reconstruisez les automatisations en dernier, puisque chaque identifiant d'entité change avec la nouvelle intégration.
Un réappairage complet est fastidieux plus que difficile. Le faire pièce par pièce garde la maison fonctionnelle pendant l'opération et montre tout de suite quel appareil n'a pas rejoint.
Changer de clé sans réappairer
Remplacer un coordinateur mort ou dépassé est une autre opération, qui peut éviter le réappairage, mais seulement au sein du même logiciel et pour certaines familles de puces. ZHA sait migrer le réseau entre clés Silicon Labs, Texas Instruments et ConBee/RaspBee si la sauvegarde a été faite dans ZHA. Zigbee2MQTT prend en charge la sauvegarde et la restauration pour les clés Texas Instruments (zstack) et Silicon Labs (ember), et passer à un autre type de clé y impose un réappairage.
Notre guide sur les canaux Zigbee indique où chaque outil range cette sauvegarde. Copiez-la régulièrement hors de la machine : c'est le fichier qui transforme une clé grillée en opération de dix minutes au lieu d'un week-end.
Sources
- Documentation de l'intégration ZHA de Home Assistant
- Zigbee2MQTT : démarrage
- FAQ Zigbee2MQTT : clés, sauvegarde et réappairage
- Dépôt zigpy
Vérifié le 7 octobre 2026. Les licences viennent du fichier de licence de chaque dépôt, via l'API GitHub à cette date.
Questions fréquentes
Peut-on passer de ZHA à Zigbee2MQTT sans réappairer ?
Non. Les deux projets indiquent qu'un appareil déjà appairé à une autre implémentation Zigbee doit être réinitialisé avant de pouvoir rejoindre.
Zigbee2MQTT a-t-il besoin de Home Assistant ?
Non. Il publie les appareils via MQTT, donc tout client MQTT peut les utiliser. Home Assistant n'est que l'un d'eux.
ZHA a-t-il besoin d'un broker MQTT ?
Non. ZHA est intégré à Home Assistant et parle directement à la clé via la bibliothèque zigpy.
Les deux sont-ils open source ?
Oui. Zigbee2MQTT et zigpy sont sous GPL-3.0 ; Home Assistant, qui inclut ZHA, est sous Apache-2.0.
À lire ensuite
Appairage« Cet appareil nécessite un routeur de bordure Thread » : la vraie solution
Le message ne veut presque jamais dire ce qu'il annonce. Neuf fois sur dix le routeur de bordure existe déjà et c'est l'IPv6 qui est cassé.
RadioZigbee et Wi-Fi en 2,4 GHz : choisir le canal qui arrête les décrochages
Les canaux Zigbee 15, 20 et 25 existent pour une raison. Voici la carte des recouvrements et comment changer sans réappairer quarante appareils.
DurabilitéLe grand débranchement : acheter du matériel qui survit à son fabricant
Le cloud Wemo s'est éteint en janvier 2026. Voici le test en quatre questions que nous passons avant tout achat.