Oubliez pas de liker la page pour me suivre

Rejoignez-nous sur Facebook

19 décembre 2025

[TUTO] Installer Zigbee2MQTT sur Home Assistant : guide complet pas à pas

Zigbee est aujourd’hui l’un des protocoles les plus populaires en domotique. Stable, rapide et peu énergivore, il permet de connecter facilement des capteurs, ampoules, prises et bien d’autres appareils.

Parmi les solutions disponibles, Zigbee2MQTT est l’une des plus complètes et des plus flexibles pour gérer un réseau Zigbee dans Home Assistant.

Dans cet article, nous allons voir comment installer et configurer Zigbee2MQTT sur Home Assistant, étape par étape.

Pourquoi choisir Zigbee2MQTT ?

Zigbee2MQTT présente plusieurs avantages :

  • ✅ Compatibilité avec un très grand nombre d’appareils Zigbee

  • ✅ Indépendant des marques (Xiaomi, IKEA, Sonoff, Aqara, Tuya, etc.)

  • ✅ Interface web claire pour gérer le réseau

  • ✅ Mises à jour fréquentes

  • ✅ Intégration parfaite avec Home Assistant via MQTT

Contrairement à ZHA (l’intégration Zigbee native), Zigbee2MQTT offre plus de contrôle et une compatibilité souvent plus large.


Prérequis

Avant de commencer, assurez-vous d’avoir :

  • 🏠 Home Assistant OS ou Supervised

  • 📡 Une clé Zigbee compatible (exemples : Sonoff ZBDongle-P, Sonoff ZBDongle-E, ConBee II, CC2652)

  • 📶 Un broker MQTT fonctionnel (Mosquitto recommandé)

  • 💻 Un accès administrateur à Home Assistant


Étape 1 : Installer le broker MQTT (Mosquitto)

Zigbee2MQTT fonctionne avec MQTT, il est donc indispensable d’avoir un broker.

  1. Allez dans Paramètres → Modules complémentaires

  2. Cliquez sur Boutique des modules complémentaires

  3. Recherchez Mosquitto broker

  4. Installez-le

  5. Démarrez l’add-on

  6. Activez les options Démarrer au démarrage, Surveiller et Watchdog

👉 Pensez à créer un utilisateur MQTT dans
Paramètres → Personnes → Utilisateurs (ou utilisez un utilisateur existant).


Étape 2 : Installer Zigbee2MQTT

Ajouter le dépôt officiel

  1. Allez dans Paramètres → Modules complémentaires

  2. Cliquez sur Boutique des modules complémentaires

  3. Menu ⋮ → Dépôts

  4. Ajoutez le dépôt suivant :

https://github.com/zigbee2mqtt/hassio-zigbee2mqtt

Installer l’add-on

  1. Recherchez Zigbee2MQTT

  2. Cliquez sur Installer

  3. Attendez la fin de l’installation


Étape 3 : Configurer Zigbee2MQTT

Avant de démarrer Zigbee2MQTT, une configuration est nécessaire.

Identifier le port de la clé Zigbee

  1. Allez dans Paramètres → Système → Matériel → Ports

  2. Repérez votre clé Zigbee
    Exemple :

/dev/serial/by-id/usb-ITead_Sonoff_Zigbee_3.0_USB_Dongle_Plus-xxxxxxxx

👉 Utilisez toujours le chemin /by-id/ pour éviter les problèmes au redémarrage.


Configuration de base

Dans l’onglet Configuration de Zigbee2MQTT, adaptez les paramètres suivants :

serial:
  port: /dev/serial/by-id/usb-XXXXXXXX
mqtt:
  server: mqtt://core-mosquitto
  user: mqtt_user
  password: mqtt_password
homeassistant: true
frontend: true

💡 Remplacez mqtt_user et mqtt_password par vos identifiants précédement créé.


Étape 4 : Démarrer Zigbee2MQTT

  1. Enregistrez la configuration

  2. Démarrez l’add-on Zigbee2MQTT

  3. Ouvrez les logs pour vérifier qu’il démarre sans erreur

Si tout est correct, l’interface web Zigbee2MQTT sera accessible via :

Paramètres → Modules complémentaires → Zigbee2MQTT → Ouvrir l’interface

 

Étape 5 : Ajouter Zigbee2MQTT dans Home Assistant

  1. Allez dans Paramètres → Appareils et services

  2. Home Assistant détecte automatiquement MQTT

  3. Cliquez sur Configurer

  4. Validez

🎉 Zigbee2MQTT est maintenant connecté à Home Assistant !


Étape 6 : Ajouter un appareil Zigbee

  1. Ouvrez l’interface Zigbee2MQTT

  2. Cliquez sur Autoriser l’appairage

  3. Mettez votre appareil Zigbee en mode appairage

  4. Attendez qu’il apparaisse dans la liste

L’appareil sera automatiquement ajouté dans Home Assistant, prêt à être utilisé dans vos automatisations.


Conseils et bonnes pratiques

  • 🔁 Placez des routeurs Zigbee (prises, ampoules alimentées) pour renforcer le maillage

  • 🧱 Évitez de brancher la clé Zigbee directement sur un port USB proche du Wi-Fi (utilisez une rallonge USB)

  • 🔄 Sauvegardez régulièrement la configuration de Zigbee2MQTT

  • 🔔 Consultez la documentation officielle pour les appareils spécifiques


Conclusion

Zigbee2MQTT est une solution puissante et fiable pour gérer un réseau Zigbee avec Home Assistant.
Même si l’installation demande un peu plus de configuration qu’une solution native, elle offre une compatibilité étendue, plus de contrôle et une excellente stabilité.

Si vous le souhaitez, pour aller plus loins, apprenez a améliorer le réseau Zigbee au maximum pour en profiter au mieux.Cliquez ici pour passer a la lecture.

À très vite sur Le blog de Loïc 🚀

Le
Labels: