Zigbee2MQTT est un logiciel libre qui remplace le hub propriétaire d’un fabricant. Branché sur une clé USB faisant office de coordinateur, il traduit les échanges de vos appareils Zigbee en messages MQTT, compréhensibles par un serveur domotique comme Home Assistant. Résultat : vos capteurs et vos ampoules restent chez vous, sans boîtier fermé ni cloud imposé.
Zigbee2MQTT : une passerelle logicielle entre Zigbee et MQTT
Le Zigbee est un protocole radio basse consommation utilisé par une grande partie des objets connectés du logement : ampoules, prises, capteurs d’ouverture, thermostats, détecteurs de fumée. Sa faiblesse historique n’est pas la radio mais la couche logicielle, car chaque marque impose souvent son propre boîtier, sa propre application et son propre compte en ligne.
MQTT, de son côté, est un protocole de messagerie très léger, né dans le monde industriel. Un objet publie un message sur un sujet, un autre s’y abonne. C’est un standard ouvert, parfaitement adapté à la domotique locale.
Zigbee2MQTT fait le pont entre les deux mondes. Le logiciel pilote un coordinateur Zigbee branché en USB, écoute les trames radio, les convertit en sujets MQTT lisibles, puis renvoie les ordres dans l’autre sens. Vous obtenez une passerelle logicielle, mise à jour par une communauté active, qui reconnaît des milliers de références d’appareils.
Comment Zigbee2MQTT s’insère dans une installation domotique
La chaîne de communication se lit de gauche à droite. Les appareils Zigbee parlent au coordinateur USB par ondes radio. Zigbee2MQTT lit ce coordinateur et publie les états sur un courtier MQTT, souvent Mosquitto. Le logiciel de domotique s’abonne à ces sujets et affiche températures, états de contact ou consommations.
Cette architecture en couches a un avantage concret : chaque brique peut être remplacée sans tout casser. Vous changez de logiciel domotique, le courtier MQTT reste. Vous changez de clé Zigbee, les scénarios restent. Rien n’est verrouillé par un fabricant.
Le tableau de bord web intégré à Zigbee2MQTT permet aussi de vérifier le réseau radio, la qualité des liaisons et la carte des routes entre appareils. C’est l’outil de diagnostic le plus utile quand un capteur décroche.
Le matériel et les prérequis avant d’installer Zigbee2MQTT
Trois éléments sont indispensables : un coordinateur Zigbee compatible, une machine pour héberger le logiciel, et un courtier MQTT. Le reste est confort.
- Le coordinateur : une clé USB à puce récente (CC2652, EFR32, ou les modèles Sonoff ZBDongle-P et ZBDongle-E). Les anciennes puces CC2531 sont dépassées et limitent le nombre d’appareils.
- Le serveur : Raspberry Pi, mini PC, NAS ou machine virtuelle. Comptez une alimentation stable et un système à jour.
- Le courtier MQTT : Mosquitto fait référence. Il tourne sur la même machine dans la majorité des cas.
- Une rallonge USB : elle éloigne la clé du boîtier et des ports USB 3.0, sources de parasites en 2,4 GHz.
Avant de multiplier les modules, un coup d’oeil au tableau électrique évite bien des surprises. Le Calculateur charge Guidelec permet d’estimer la puissance disponible et de vérifier que l’ajout de prises pilotées ne déséquilibre pas une ligne déjà chargée.
Deux points de vigilance électrique reviennent souvent. Dans un logement alimenté en triphasé, un module mal raccordé peut créer un dysfonctionnement difficile à diagnostiquer : la méthode pour Brancher une prise triphasé rappelle les vérifications indispensables avant de refermer un boîtier. Et si un petit serveur ou un module fonctionne en courant continu, mieux vaut un Transformateur 220V 12V correctement dimensionné qu’une alimentation de récupération douteuse.
Installer et configurer Zigbee2MQTT avec Home Assistant
L’installation la plus simple passe par les modules complémentaires de Home Assistant. Voici la séquence, valable pour une installation neuve en 2026.
- Branchez le coordinateur sur un port USB libre, idéalement via une rallonge, puis redémarrez la machine.
- Installez le module Mosquitto broker et créez un utilisateur dédié dans Home Assistant, avec un mot de passe solide.
- Installez le module Zigbee2MQTT, puis renseignez l’adresse du courtier, l’utilisateur et le mot de passe.
- Déclarez le port du coordinateur en chemin stable, du type /dev/serial/by-id/, plutôt qu’un /dev/ttyUSB0 qui peut changer après un redémarrage.
- Choisissez un canal Zigbee éloigné de votre Wi-Fi, puis laissez Zigbee2MQTT générer sa clé réseau. Sauvegardez cette clé hors de la machine.
- Ouvrez l’interface web sur le port 8099 et vérifiez que le coordinateur est bien détecté.
La configuration tient dans un fichier unique, ce qui facilite les sauvegardes. Copiez régulièrement le dossier de données : il contient la clé réseau, la liste des appareils et leurs noms. Sans cette copie, une réinstallation oblige à tout appairer de nouveau.
Le serveur domotique doit rester joignable en permanence. Si la box est loin du local technique, un Répéteur Wi-Fi Free bien placé suffit souvent à stabiliser la liaison, à condition de ne pas le coller contre le boîtier électrique.
Appairer et piloter les appareils Zigbee compatibles
L’appairage se lance depuis l’interface, via le bouton d’autorisation d’ajout. Placez l’appareil à moins d’un mètre du coordinateur pour la première connexion, puis installez-le à sa place définitive. Zigbee2MQTT nomme chaque entité et expose ses capacités : état, luminosité, température, consommation.
| Type d’appareil | Usage typique | Point d’attention |
|---|---|---|
| Ampoule ou bandeau | Éclairage et scénarios | Vérifier la compatibilité des couleurs |
| Prise pilotée | Mesure de consommation | Respecter la puissance maximale |
| Capteur d’ouverture | Alarme et présence | Coller l’aimant bien aligné |
| Thermostat | Chauffage pièce par pièce | Prévoir un routeur à proximité |
| Détecteur de mouvement | Éclairage automatique | Régler la sensibilité après pose |
Les appareils sur secteur, comme les prises et les ampoules, servent aussi de routeurs : ils relaient le signal des capteurs sur pile. Un réseau dense en modules alimentés est donc bien plus fiable qu’un réseau composé uniquement de capteurs à batterie.
Si vous automatisez la recharge d’un véhicule, la démarche pour Installer une borne de recharge à domicile mérite d’être préparée en amont, car le pilotage de la charge se combine mal avec une installation électrique sous-dimensionnée.
Erreurs fréquentes et conseils pour un réseau Zigbee stable
La plupart des problèmes attribués à Zigbee2MQTT viennent de l’environnement radio, pas du logiciel.
- Canal en conflit avec le Wi-Fi : les canaux Zigbee 11, 15, 20 et 25 cohabitent mieux avec les canaux Wi-Fi 1, 6 et 11. Testez, puis gardez le même canal.
- Clé USB collée au boîtier : les ports USB 3.0 émettent des parasites. Une rallonge de 50 cm à un mètre règle souvent les décrochages.
- Réseau trop pauvre en routeurs : ajoutez une prise ou une ampoule sur secteur entre le coordinateur et les pièces éloignées.
- Firmware du coordinateur obsolète : une mise à jour corrige des bugs de stabilité et améliore la prise en charge des nouveaux appareils.
- Aucune sauvegarde : clé réseau et base d’appareils doivent être copiées ailleurs.
- Appairage à distance : un appareil appairé trop loin s’associe mal et reste instable ensuite.
Un dernier conseil de méthode : modifiez une seule chose à la fois. Changer de canal, de clé et de version logicielle le même soir rend le diagnostic impossible. Notez ce que vous faites, et laissez le réseau tourner quelques jours avant de juger.
Zigbee2MQTT face aux autres solutions du marché
| Solution | Approche | Pour qui |
|---|---|---|
| Zigbee2MQTT | Passerelle logicielle ouverte | Utilisateurs qui veulent tout maîtriser |
| ZHA | Intégration native dans Home Assistant | Installation simple, sans courtier MQTT |
| Deconz | Boîtier et logiciel propriétaires | Parc d’appareils restreint |
| Hub constructeur | Écosystème fermé | Usage sans configuration |
Le choix dépend surtout de votre tolérance à la configuration. Zigbee2MQTT demande une soirée de mise en place, puis se montre très souple : compatibilité large, mises à jour fréquentes, indépendance vis-à-vis des marques. Pour un logement équipé progressivement, c’est un investissement de temps qui se rentabilise vite.
Zigbee2MQTT est-il gratuit ?
Oui. Le logiciel est publié sous licence libre et ne demande ni abonnement ni compte en ligne. Le seul coût réel concerne le matériel : la clé USB faisant office de coordinateur et la machine qui héberge le logiciel.
Faut-il obligatoirement Home Assistant pour utiliser Zigbee2MQTT ?
Non. Home Assistant est la combinaison la plus documentée, mais Zigbee2MQTT fonctionne avec n’importe quel système capable de lire du MQTT : Jeedom, Domoticz, Node-RED ou même un simple script. Le courtier MQTT joue le rôle de plaque tournante.
Quelle clé USB Zigbee choisir pour Zigbee2MQTT ?
Privilégiez une puce récente, de type CC2652 ou EFR32, avec une antenne correcte et un firmware à jour. Les modèles à base de CC2531 restent fonctionnels mais limitent le nombre d’appareils et la portée, ce qui devient gênant au-delà d’une dizaine de modules.
Zigbee2MQTT fonctionne-t-il sans connexion Internet ?
Oui, une fois installé et configuré. Le coordinateur, le courtier MQTT et le logiciel domotique communiquent en réseau local. Une coupure Internet n’empêche donc pas vos scénarios de continuer à fonctionner, à condition de ne pas dépendre d’un service en ligne.
Combien d’appareils Zigbee peut gérer Zigbee2MQTT ?
La limite vient surtout du coordinateur et de la densité du réseau. Un coordinateur moderne gère couramment plusieurs dizaines d’appareils, à condition d’ajouter suffisamment de modules sur secteur pour relayer le signal dans les pièces éloignées.