Passer à zigbee2mqtt home assistant donne accès à un écosystème Zigbee plus flexible et robuste que l’intégration native ZHA. Cette solution sépare le réseau radio de Home Assistant, offre une visualisation détaillée du maillage et supporte des centaines de dispositifs supplémentaires grâce à la base de données communautaire. Si votre installation grandit ou si certains appareils restent capricieux sous ZHA, Zigbee2MQTT devient le choix logique. Ce guide détaille l’installation, la configuration et les bénéfices concrets pour une domotique locale performante en 2026.
Sommaire
Pourquoi choisir Zigbee2MQTT plutôt que ZHA dans Home Assistant
Zigbee2MQTT fonctionne comme un add-on indépendant. Votre réseau Zigbee continue de tourner même pendant les mises à jour de Home Assistant. La visualisation du maillage montre précisément les routes, les LQI et les nœuds faibles. Vous accédez aussi à des outils avancés comme les bindings directs, les groupes étendus et les exposés MQTT bruts pour des automatisations sur mesure.
La base de support matériel dépasse largement celle de ZHA. Des milliers de références bénéficient de quirks communautaires mis à jour chaque semaine. Les utilisateurs qui dépassent 50 appareils ou qui intègrent des marques moins courantes comme Tuya, Aqara ou Xiaomi passent souvent à cette solution pour éviter les pertes de connexion.
Comme vu dans le guide principal sur zigbee home assistant avec ZHA, la simplicité native convient aux débuts. Mais dès que la stabilité ou le nombre d’appareils augmentent, Zigbee2MQTT prend le relais sans réappairage complet.
Prérequis matériels et logiciels avant l’installation
Un coordinateur Zigbee compatible reste indispensable. Les puces EFR32MG24 comme le Sonoff Zigbee 3.0 Dongle Plus ou le SMLight SLZB-06MG24 excellent ici. Un broker MQTT est obligatoire : l’add-on Mosquitto de Home Assistant suffit largement.
| Composant | Recommandation | Raison |
|---|---|---|
| Coordinateur | Sonoff MG24 ou SLZB-06 | Puissance d’émission élevée, firmware facile à mettre à jour, support complet Ember ou Z-Stack |
| Broker MQTT | Mosquitto add-on | Intégration native, configuration automatique avec Zigbee2MQTT |
| Version Home Assistant | 2025.12 ou supérieure | Meilleure découverte MQTT et stabilité de l’add-on officiel |
Installez d’abord Mosquitto via le store des add-ons. Notez l’utilisateur et le mot de passe créés automatiquement. Ces identifiants serviront pour la liaison avec Zigbee2MQTT.
Installer Zigbee2MQTT étape par étape
Allez dans Paramètres > Appareils et services > Add-ons. Recherchez Zigbee2MQTT dans le store officiel et installez-le. Une fois lancé, ouvrez l’interface web de l’add-on (port 8099 par défaut).
L’onboarding apparaît au premier démarrage. Sélectionnez votre coordinateur dans la liste détectée. Choisissez le type de radio (ember ou zstack selon le modèle). Entrez l’adresse du broker MQTT (généralement core-mosquitto ou l’IP de votre instance) ainsi que les identifiants. Validez. Le réseau se crée en quelques secondes.
Dans la configuration avancée, activez la découverte Home Assistant pour que les entités apparaissent automatiquement. Activez aussi les logs détaillés pendant les premiers tests.
Associer vos premiers appareils sous Zigbee2MQTT
Depuis l’interface Zigbee2MQTT, cliquez sur Permettre l’appairage. Mettez l’appareil en mode pairing. Le nom, le modèle et les entités s’affichent immédiatement. Renommez-les et assignez-les à une pièce pour une meilleure organisation.
Les routeurs (prises, ampoules filaires) s’ajoutent en priorité pour étendre le maillage. Les capteurs sur pile rejoignent ensuite. La carte réseau interactive montre chaque lien radio en temps réel. Si un nœud apparaît en rouge, ajoutez un routeur intermédiaire.
Avantages concrets et fonctionnalités avancées
Zigbee2MQTT propose plusieurs outils que ZHA ne possède pas :
- Visualisation complète du maillage avec force des signaux et routes optimisées.
- Bindings directs entre appareils sans passer par Home Assistant.
- Exposition MQTT fine pour des scripts externes ou Node-RED.
- Mises à jour OTA groupées et gestion des quirks personnalisés.
- Possibilité de faire tourner l’add-on sur une machine séparée pour une isolation totale.
Les automatisations restent identiques à celles créées sous ZHA. Vous retrouvez toutes les entités dans Home Assistant via la découverte MQTT. La migration depuis ZHA se fait en exportant le réseau et en important la base dans Zigbee2MQTT sans réinitialiser les appareils.
Optimiser et dépanner votre réseau Zigbee2MQTT
Choisissez un canal Zigbee éloigné de votre Wi-Fi. Activez les rapports périodiques pour les capteurs de consommation. Surveillez les statistiques dans l’onglet Network : un bon maillage montre plus de 80 % de nœuds avec LQI supérieur à 100.
En cas de problème d’appairage, utilisez le mode debug et consultez le journal. La communauté maintient une liste exhaustive sur zigbee.blakadder.com avec les quirks spécifiques. Une sauvegarde du fichier database.db permet de restaurer tout le réseau en cas de changement de coordinateur.
Avec zigbee2mqtt home assistant, votre installation gagne en fiabilité et en évolutivité. Vous gérez des centaines d’appareils sans compromettre les performances. Si vous avez suivi le notre guide sur Zigbee Home Assistant et que vous ressentez les limites, cette solution constitue l’étape naturelle suivante. Testez-la sur un second coordinateur en parallèle si vous voulez migrer progressivement. Votre domotique locale devient alors vraiment autonome et prête à grandir sans limite.