Home Assistant et Zigbee2MQTT est actuellement l’une des meilleures combinaisons pour profiter d’une maison connectée avec la technologie Zigbee en pouvant mixer la majorité des marques du marché de la domotique.
Comment configurer Home Assistant et Zigbee2MQTT ?
Si vous avez déjà votre box domotique Home Assistant installée comme par exemple Home Assistant Green, vous devez accéder à son adresse locale: homeassistant.local:8123.
![Home Assistant et Zigbee2MQTT : installation et configuration 3 Installation de Zigbee2MQTT sur Home Assistant](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-1024x638.png)
Installation du broker MQTT sur Home Assistant
La première étape consiste à installer un broker MQTT. Rendez-vous sur l’onglet « Paramètres » puis « Modules complémentaires ».
![Home Assistant et Zigbee2MQTT : installation et configuration 4 Installation du broker MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-1-1024x595.png)
Recherchez « Mosquitto ».
![Home Assistant et Zigbee2MQTT : installation et configuration 5 Installation du broker MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-2-1024x637.png)
Cliquez sur « Mosquitto Broker ».
![Home Assistant et Zigbee2MQTT : installation et configuration 6 Installation du broker MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-3-1024x638.png)
Cliquez sur « Installer ».
![Home Assistant et Zigbee2MQTT : installation et configuration 7 Installation du broker MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-4-1024x637.png)
Vous pouvez activer en option le « Chien de garde ».
![Home Assistant et Zigbee2MQTT : installation et configuration 8 Installation du broker MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-5-1024x636.png)
Ensuite, il faudra créer un utilisateur. Pour cela, rendez-vous dans « Paramètres » puis « Personnes ».
![Home Assistant et Zigbee2MQTT : installation et configuration 9 Création d'un utilisateur sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-7-1024x639.png)
Cliquez sur « Ajouter une personne ».
![Home Assistant et Zigbee2MQTT : installation et configuration 10 Création d'un utilisateur sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-8-1024x637.png)
Renseignez un nom.
![Home Assistant et Zigbee2MQTT : installation et configuration 11 Création d'un utilisateur sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-9-1024x638.png)
Renseignez un mot de passe et cliquez sur « Créer ».
![Home Assistant et Zigbee2MQTT : installation et configuration 12 Création d'un utilisateur sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-10-1024x636.png)
Rendez-vous sur « Paramètres » puis retournez sur « Modules complémentaires » et « Mosquitto Broker ».
![Home Assistant et Zigbee2MQTT : installation et configuration 13 Installation du broker MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-11-1024x640.png)
Cliquez sur « Démarrer ».
![Home Assistant et Zigbee2MQTT : installation et configuration 14 Installation du broker MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-12-1024x637.png)
Cliquez sur l’onglet « Journal ».
![Home Assistant et Zigbee2MQTT : installation et configuration 15 Installation du broker MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-13-1024x638.png)
Lorsque vous avez le message « Successfully send service information to the Supervisor », cela signifie que votre Broker MQTT est fonctionnel.
![Home Assistant et Zigbee2MQTT : installation et configuration 16 Installation du broker MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-14-1024x639.png)
Rendez-vous dans « Paramètres », puis « Appareils et services ».
![Home Assistant et Zigbee2MQTT : installation et configuration 17 Installation du broker MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-15-1024x638.png)
Cliquez sur « Configurer » dans MQTT.
![Home Assistant et Zigbee2MQTT : installation et configuration 18 Installation du broker MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-16-1024x638.png)
Cliquez sur l’option « MQTT ».
![Home Assistant et Zigbee2MQTT : installation et configuration 19 Installation du broker MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-17-1024x638.png)
Renseignez les informations suivantes:
- Courtier: 127.0.0.1
- Port: 1883
- Nom d’utilisateur (précédemment crée)
- Mot de passe de l’utilisateur (précédemment crée)
Cliquez sur « Valider ».
![Home Assistant et Zigbee2MQTT : installation et configuration 20 Installation du broker MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-18-1024x637.png)
Enfin, si vous avez le message « Succès! », cliquez sur « Terminer ».
![Home Assistant et Zigbee2MQTT : installation et configuration 21 Installation du broker MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-19-1024x636.png)
Installation de Zigbee2MQTT sur Home Assistant
Désormais, vous pouvez installer Zigbee2MQTT. Pour cela, rendez-vous sur le Github de Zigbee2MQTT et copier le lien du dossier contenant Zigbee2MQTT.
![Home Assistant et Zigbee2MQTT : installation et configuration 22 Installation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-20-1024x638.png)
Rendez-vous dans « Paramètres » puis « Modules complémentaires ».
![Home Assistant et Zigbee2MQTT : installation et configuration 23 Installation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-21-1024x638.png)
Cliquez sur l’onglet en haut à droite puis sur « Dépôts ».
![Home Assistant et Zigbee2MQTT : installation et configuration 24 Installation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-22-1024x641.png)
Collez le lien précédemment copié. Cliquez sur « Ajouter ».
![Home Assistant et Zigbee2MQTT : installation et configuration 25 Installation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-23-1024x638.png)
Désormais, dans « Paramètres », « Modules complémentaires » puis « Boutique des modules complémentaires » (onglet en bas à droite), vous trouverez Zigbee2MQTT.
Cliquez sur Zigbee2MQTT.
![Home Assistant et Zigbee2MQTT : installation et configuration 26 Installation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-24-1024x640.png)
Cliquez sur « Installer ».
![Home Assistant et Zigbee2MQTT : installation et configuration 27 Installation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-25-1024x640.png)
Maintenant, nous allons identifier l’ID de notre clé Zigbee. Dans notre exemple, nous utiliserons la clé Zigbee Skyconnect. Mais vous pouvez utiliser d’autres clés Zigbee compatibles (Sonoff, SMLight, Conbeeiii et bien plus).
![Home Assistant et Zigbee2MQTT : installation et configuration 28 Installation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-1-1024x576.jpg)
Rendez-vous sur « Paramètres » puis « Système ».
![Home Assistant et Zigbee2MQTT : installation et configuration 29 Installation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-26-1024x637.png)
Cliquez sur « Matériel ».
![Home Assistant et Zigbee2MQTT : installation et configuration 30 Installation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-27-1024x638.png)
Cliquez sur « Tout le matériel ».
![Home Assistant et Zigbee2MQTT : installation et configuration 31 Installation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-28-1024x637.png)
Enfin, dans la liste déroulante, vous devriez retrouver votre clé Zigbee avec un ID spécifique. Copiez cet ID.
![Home Assistant et Zigbee2MQTT : installation et configuration 32 Installation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-29-1024x641.png)
Accédez à « Modules complémentaires » puis « Zigbee2MQTT ».
![Home Assistant et Zigbee2MQTT : installation et configuration 33 Installation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-30-1024x637.png)
Cliquez sur « Configuration ».
![Home Assistant et Zigbee2MQTT : installation et configuration 34 Installation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-31-1024x638.png)
Renseignez dans « Mqtt »:
base_topic: zigbee2mqtt
![Home Assistant et Zigbee2MQTT : installation et configuration 35 Installation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-32-1024x638.png)
Dans « Serial », écrivez:
port: votre ID (précédemment copié).
![Home Assistant et Zigbee2MQTT : installation et configuration 36 Installation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-33-1024x639.png)
Enfin, rajoutez le type d’adaptateur correspondant à votre clé USB Zigbee, dans notre exemple:
adapter: ezsp
![Home Assistant et Zigbee2MQTT : installation et configuration 37 Installation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-34-1024x638.png)
Retournez dans « Info » et cliquez sur « Démarrer ».
![Home Assistant et Zigbee2MQTT : installation et configuration 38 Installation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-35-1024x638.png)
Accédez à « Journal » et vérifiez les logs pour s’assurer que Zigbee2MQTT fonctionne correctement. Cliquez sur « Actualiser » après quelques secondes d’attente pour visualiser de nouveaux logs.
![Home Assistant et Zigbee2MQTT : installation et configuration 39 Installation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-36-1024x639.png)
Lorsque vous avez le message « Z2m: Zigbee2MQTT started! », Zigbee2MQTT est fonctionnel.
![Home Assistant et Zigbee2MQTT : installation et configuration 40 Installation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-37-1024x639.png)
Vous pouvez en option activer le « Chien de garde » pour redémarrer automatiquement Zigbee2MQTT en cas de panne et « Afficher dans la barre latérale » pour un accès direct de Zigbee2MQTT qui s’affichera sur votre menu à gauche.
![Home Assistant et Zigbee2MQTT : installation et configuration 41 Installation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-38-1024x637.png)
Désormais, depuis le menu à gauche, nous avons Zigbee2MQTT visible, cliquez sur cet onglet.
![Home Assistant et Zigbee2MQTT : installation et configuration 42 Utilisation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-39-1024x638.png)
Vous allez pouvoir inclure tous vos dispositifs Zigbee.
![Home Assistant et Zigbee2MQTT : installation et configuration 42 Utilisation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-39-1024x638.png)
Le compte à rebours est lancé, vous allez pouvoir appairer vos différents dispositifs Zigbee à ce moment.
![Home Assistant et Zigbee2MQTT : installation et configuration 44 Utilisation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-1024x576.jpg)
Nous apercevons notre premier dispositif Zigbee.
![Home Assistant et Zigbee2MQTT : installation et configuration 45 Utilisation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-40-1024x638.png)
Vous pouvez continuer vos appairages de produits Zigbee. Une fois tous vos produits inclus, vous pouvez cliquer sur « Désactiver l’appairage ».
![Home Assistant et Zigbee2MQTT : installation et configuration 46 Utilisation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-41-1024x624.png)
Désormais, vous avez accès à vos dispositifs Zigbee depuis l’interface de votre box Home Assistant et Zigbee2MQTT et vous pouvez accéder aux paramètres de ceux-ci pour personnaliser les usages.
![Home Assistant et Zigbee2MQTT : installation et configuration 47 Utilisation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-42-1024x639.png)
Dans « Paramètres (spécifiques) », nous avons accès à plus de paramètres.
![Home Assistant et Zigbee2MQTT : installation et configuration 48 Utilisation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-43-1024x638.png)
Dans « Schéma », vous pouvez suivre votre maillage Zigbee. En effet, le réseau Zigbee est maillé, les dispositifs Zigbee pourront communiquer entre eux pour améliorer la portée de communication.
![Home Assistant et Zigbee2MQTT : installation et configuration 49 Utilisation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-44-1024x637.png)
Dans « Aperçu », vous pouvez contrôler vos dispositifs et visualiser leurs états.
![Home Assistant et Zigbee2MQTT : installation et configuration 50 Utilisation de Zigbee2MQTT sur Home Assistant.](https://blog.domadoo.fr/wp-content/uploads/2024/05/home-assistant-et-zigbee2mqtt-installation-configuration-45-1024x639.png)