{"id":555,"date":"2026-09-18T17:02:14","date_gmt":"2026-09-18T17:02:14","guid":{"rendered":"https:\/\/aes-montbrison.fr\/blog\/alarme-detection\/mqtt-zigbee2mqtt-homeassistant\/"},"modified":"2026-09-18T18:06:47","modified_gmt":"2026-09-18T18:06:47","slug":"mqtt-zigbee2mqtt-homeassistant","status":"publish","type":"post","link":"https:\/\/aes-montbrison.fr\/blog\/alarme-detection\/mqtt-zigbee2mqtt-homeassistant\/","title":{"rendered":"Guide complet pour configurer MQTT et Zigbee2MQTT sur Home Assistant 2024"},"content":{"rendered":"<p class=\"wp-block-paragraph\"><strong>En bref<\/strong><\/p>\n\n<ul class=\"wp-block-list\"><li><strong>MQTT<\/strong> sert de messagerie locale entre les \u00e9quipements et Home Assistant, tandis que <strong>Zigbee2MQTT<\/strong> traduit les \u00e9changes du r\u00e9seau Zigbee en messages exploitables.<\/li><li>Une installation supervis\u00e9e dans Home Assistant facilite les red\u00e9marrages automatiques, les sauvegardes et le suivi des journaux.<\/li><li>Le choix du coordinateur, son port stable et son emplacement physique ont un effet direct sur la fiabilit\u00e9 du r\u00e9seau zigbee.<\/li><li>Un compte MQTT d\u00e9di\u00e9, un mot de passe robuste et une sauvegarde externe \u00e9vitent les erreurs les plus co\u00fbteuses \u00e0 corriger.<\/li><\/ul>\n\n<div id=\"ez-toc-container\" class=\"ez-toc-v2_0_87 counter-hierarchy ez-toc-counter ez-toc-grey ez-toc-container-direction\">\n<div class=\"ez-toc-title-container\">\n<p class=\"ez-toc-title\" style=\"cursor:inherit\">Sommaire<\/p>\n<span class=\"ez-toc-title-toggle\"><a href=\"#\" class=\"ez-toc-pull-right ez-toc-btn ez-toc-btn-xs ez-toc-btn-default ez-toc-toggle\" aria-label=\"Toggle Table of Content\"><span class=\"ez-toc-js-icon-con\"><span class=\"\"><span class=\"eztoc-hide\" style=\"display:none;\">Toggle<\/span><span class=\"ez-toc-icon-toggle-span\"><svg style=\"fill: #999;color:#999\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" class=\"list-377408\" width=\"20px\" height=\"20px\" viewBox=\"0 0 24 24\" fill=\"none\"><path d=\"M6 6H4v2h2V6zm14 0H8v2h12V6zM4 11h2v2H4v-2zm16 0H8v2h12v-2zM4 16h2v2H4v-2zm16 0H8v2h12v-2z\" fill=\"currentColor\"><\/path><\/svg><svg style=\"fill: #999;color:#999\" class=\"arrow-unsorted-368013\" xmlns=\"http:\/\/www.w3.org\/2000\/svg\" width=\"10px\" height=\"10px\" viewBox=\"0 0 24 24\" version=\"1.2\" baseProfile=\"tiny\"><path d=\"M18.2 9.3l-6.2-6.3-6.2 6.3c-.2.2-.3.4-.3.7s.1.5.3.7c.2.2.4.3.7.3h11c.3 0 .5-.1.7-.3.2-.2.3-.5.3-.7s-.1-.5-.3-.7zM5.8 14.7l6.2 6.3 6.2-6.3c.2-.2.3-.5.3-.7s-.1-.5-.3-.7c-.2-.2-.4-.3-.7-.3h-11c-.3 0-.5.1-.7.3-.2.2-.3.5-.3.7s.1.5.3.7z\"\/><\/svg><\/span><\/span><\/span><\/a><\/span><\/div>\n<nav><ul class='ez-toc-list ez-toc-list-level-1 eztoc-toggle-hide-by-default' ><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-1\" href=\"https:\/\/aes-montbrison.fr\/blog\/alarme-detection\/mqtt-zigbee2mqtt-homeassistant\/#Pourquoi_associer_MQTT_et_Zigbee2MQTT_dans_Home_Assistant\" >Pourquoi associer MQTT et Zigbee2MQTT dans Home Assistant<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-2\" href=\"https:\/\/aes-montbrison.fr\/blog\/alarme-detection\/mqtt-zigbee2mqtt-homeassistant\/#Preparer_le_materiel_et_securiser_la_configuration_de_Home_Assistant\" >Pr\u00e9parer le mat\u00e9riel et s\u00e9curiser la configuration de Home Assistant<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-3\" href=\"https:\/\/aes-montbrison.fr\/blog\/alarme-detection\/mqtt-zigbee2mqtt-homeassistant\/#Installer_Mosquitto_Broker_et_connecter_MQTT_a_Home_Assistant\" >Installer Mosquitto Broker et connecter MQTT \u00e0 Home Assistant<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-4\" href=\"https:\/\/aes-montbrison.fr\/blog\/alarme-detection\/mqtt-zigbee2mqtt-homeassistant\/#Installer_Zigbee2MQTT_et_declarer_le_port_du_coordinateur_Zigbee\" >Installer Zigbee2MQTT et d\u00e9clarer le port du coordinateur Zigbee<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-5\" href=\"https:\/\/aes-montbrison.fr\/blog\/alarme-detection\/mqtt-zigbee2mqtt-homeassistant\/#Appairer_les_appareils_et_construire_une_automatisation_domotique_fiable\" >Appairer les appareils et construire une automatisation domotique fiable<\/a><\/li><li class='ez-toc-page-1 ez-toc-heading-level-2'><a class=\"ez-toc-link ez-toc-heading-6\" href=\"https:\/\/aes-montbrison.fr\/blog\/alarme-detection\/mqtt-zigbee2mqtt-homeassistant\/#Sauvegarder_MQTT_et_Zigbee2MQTT_pour_eviter_de_reconstruire_le_reseau\" >Sauvegarder MQTT et Zigbee2MQTT pour \u00e9viter de reconstruire le r\u00e9seau<\/a><\/li><\/ul><\/nav><\/div>\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Pourquoi_associer_MQTT_et_Zigbee2MQTT_dans_Home_Assistant\"><\/span>Pourquoi associer MQTT et Zigbee2MQTT dans Home Assistant<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n<p class=\"wp-block-paragraph\">Une installation domotique devient vite confuse lorsque chaque objet connect\u00e9 d\u00e9pend d\u2019une application, d\u2019un compte en ligne ou d\u2019une passerelle diff\u00e9rente. L\u2019association de <strong>Home Assistant, MQTT et Zigbee2MQTT<\/strong> propose une autre approche : les appareils communiquent sur le r\u00e9seau local et les donn\u00e9es restent pilotables depuis une interface centrale.<\/p>\n\n<p class=\"wp-block-paragraph\">MQTT est un protocole de messagerie l\u00e9ger. Il fonctionne selon un principe simple : un appareil publie une information sur un sujet, appel\u00e9 \u00ab topic \u00bb, et les services int\u00e9ress\u00e9s s\u2019y abonnent. Un d\u00e9tecteur d\u2019ouverture peut ainsi publier l\u2019\u00e9tat \u00ab ouvert \u00bb ou \u00ab ferm\u00e9 \u00bb. Home Assistant re\u00e7oit l\u2019information et peut d\u00e9clencher une automatisation, par exemple allumer un \u00e9clairage d\u2019entr\u00e9e entre 18 h et 7 h.<\/p>\n\n<p class=\"wp-block-paragraph\">Zigbee2MQTT joue le r\u00f4le d\u2019interpr\u00e8te entre le r\u00e9seau zigbee et le broker MQTT. Le coordinateur USB re\u00e7oit les messages radio des capteurs, prises, boutons ou ampoules. Zigbee2MQTT les convertit ensuite dans un format compris par Home Assistant. Cette architecture permet d\u2019utiliser des \u00e9quipements de fabricants diff\u00e9rents sans d\u00e9pendre de leur passerelle d\u2019origine, sous r\u00e9serve qu\u2019ils soient compatibles.<\/p>\n\n<p class=\"wp-block-paragraph\">Le b\u00e9n\u00e9fice est concret pour un foyer comme celui de Claire et Malik, propri\u00e9taires d\u2019une maison de 110 m\u00b2. Ils disposent de 14 ampoules, 6 d\u00e9tecteurs d\u2019ouverture, 3 capteurs de temp\u00e9rature et 2 prises command\u00e9es. Avec une application par marque, ils devraient g\u00e9rer plusieurs interfaces. Avec une int\u00e9gration locale, leurs sc\u00e9narios se construisent au m\u00eame endroit : baisse du chauffage si une fen\u00eatre reste ouverte 10 minutes, \u00e9clairage du couloir au passage, alerte locale lorsque la porte du garage s\u2019ouvre la nuit.<\/p>\n\n<p class=\"wp-block-paragraph\">Cette m\u00e9thode ne promet pas une maison autonome en toute circonstance. Une coupure \u00e9lectrique, un d\u00e9faut de carte m\u00e9moire ou une panne mat\u00e9rielle restent possibles. Elle r\u00e9duit toutefois les d\u00e9pendances inutiles \u00e0 Internet. Pour une commande locale, un capteur Zigbee et une automatisation Home Assistant peuvent continuer \u00e0 fonctionner si la connexion internet tombe, tant que le serveur, le routeur local et les \u00e9quipements sont aliment\u00e9s.<\/p>\n\n<p class=\"wp-block-paragraph\">Le recours \u00e0 MQTT est aussi utile au-del\u00e0 du Zigbee. Des objets Wi-Fi, des stations m\u00e9t\u00e9o, certains syst\u00e8mes d\u2019alarme compatibles ou des microcontr\u00f4leurs peuvent publier des donn\u00e9es sur le m\u00eame broker. Il faut n\u00e9anmoins s\u00e9parer les usages sensibles. Une domotique qui pilote l\u2019\u00e9clairage ou le chauffage n\u2019a pas vocation \u00e0 remplacer une alarme certifi\u00e9e ou une t\u00e9l\u00e9surveillance. Les automatismes apportent du confort et des alertes compl\u00e9mentaires, pas une garantie de protection.<\/p>\n\n<p class=\"wp-block-paragraph\">Pour comprendre la port\u00e9e et les contraintes de cette technologie radio, le guide consacr\u00e9 au <a href=\"https:\/\/aes-montbrison.fr\/blog\/alarme-detection\/zigbee-protocole-domotique\/\">protocole Zigbee en domotique<\/a> permet de distinguer les appareils sur piles des \u00e9quipements qui renforcent le maillage radio. Cette diff\u00e9rence explique de nombreux probl\u00e8mes de port\u00e9e.<\/p>\n\n<figure class=\"wp-block-table\"><table>\n<thead>\n<tr>\n<th>\u00c9l\u00e9ment<\/th>\n<th>R\u00f4le dans l\u2019installation<\/th>\n<th>Point de vigilance<\/th>\n<\/tr>\n<\/thead>\n<tbody>\n<tr>\n<td>Home Assistant<\/td>\n<td>Centralise les appareils, tableaux de bord et sc\u00e9narios<\/td>\n<td>Pr\u00e9voir une sauvegarde r\u00e9guli\u00e8re<\/td>\n<\/tr>\n<tr>\n<td>Mosquitto Broker<\/td>\n<td>Transporte les messages MQTT<\/td>\n<td>Cr\u00e9er un compte d\u00e9di\u00e9 et prot\u00e9g\u00e9<\/td>\n<\/tr>\n<tr>\n<td>Zigbee2MQTT<\/td>\n<td>Fait le lien entre Zigbee et MQTT<\/td>\n<td>Utiliser la version stable<\/td>\n<\/tr>\n<tr>\n<td>Coordinateur Zigbee<\/td>\n<td>\u00c9met et re\u00e7oit les communications radio<\/td>\n<td>\u00c9loigner l\u2019antenne des perturbations USB<\/td>\n<\/tr>\n<\/tbody>\n<\/table><\/figure>\n\n<p class=\"wp-block-paragraph\"><strong>\u00c0 retenir :<\/strong> MQTT n\u2019est pas un gadget suppl\u00e9mentaire. C\u2019est la couche de communication qui rend possible une int\u00e9gration locale, lisible et \u00e9volutive des protocoles IoT dans Home Assistant.<\/p>\n\n\n<figure class=\"wp-block-image size-large\"><img loading=\"lazy\" decoding=\"async\" width=\"1916\" height=\"821\" src=\"https:\/\/aes-montbrison.fr\/blog\/wp-content\/uploads\/2026\/09\/guide-complet-pour-configurer-mqtt-et-zigbee2mqt-illustratio.jpg\" alt=\"Coin de maison connect\u00e9e avec bo\u00eetier passerelle blanc, capteur discret et c\u00e2bles rang\u00e9s\" class=\"wp-image-557\" srcset=\"https:\/\/aes-montbrison.fr\/blog\/wp-content\/uploads\/2026\/09\/guide-complet-pour-configurer-mqtt-et-zigbee2mqt-illustratio.jpg 1916w, https:\/\/aes-montbrison.fr\/blog\/wp-content\/uploads\/2026\/09\/guide-complet-pour-configurer-mqtt-et-zigbee2mqt-illustratio-300x129.jpg 300w, https:\/\/aes-montbrison.fr\/blog\/wp-content\/uploads\/2026\/09\/guide-complet-pour-configurer-mqtt-et-zigbee2mqt-illustratio-1024x439.jpg 1024w, https:\/\/aes-montbrison.fr\/blog\/wp-content\/uploads\/2026\/09\/guide-complet-pour-configurer-mqtt-et-zigbee2mqt-illustratio-768x329.jpg 768w, https:\/\/aes-montbrison.fr\/blog\/wp-content\/uploads\/2026\/09\/guide-complet-pour-configurer-mqtt-et-zigbee2mqt-illustratio-1536x658.jpg 1536w\" sizes=\"auto, (max-width: 1916px) 100vw, 1916px\" \/><figcaption class=\"wp-element-caption\">Illustration g\u00e9n\u00e9r\u00e9e par intelligence artificielle.<\/figcaption><\/figure>\n\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Preparer_le_materiel_et_securiser_la_configuration_de_Home_Assistant\"><\/span>Pr\u00e9parer le mat\u00e9riel et s\u00e9curiser la configuration de Home Assistant<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n<p class=\"wp-block-paragraph\">Avant d\u2019installer un module compl\u00e9mentaire, il faut v\u00e9rifier le socle technique. Home Assistant OS est le choix le plus direct pour une installation supervis\u00e9e, car il donne acc\u00e8s \u00e0 la boutique d\u2019applications, aux sauvegardes et au syst\u00e8me de surveillance int\u00e9gr\u00e9. Une installation en conteneur Docker reste possible, mais elle demande davantage de manipulation pour les volumes, les p\u00e9riph\u00e9riques USB et les mises \u00e0 jour.<\/p>\n\n<p class=\"wp-block-paragraph\">Une petite machine suffit g\u00e9n\u00e9ralement pour un r\u00e9seau domestique raisonnable. Pour 20 \u00e0 60 appareils connect\u00e9s et quelques automatisations, un Raspberry Pi r\u00e9cent \u00e9quip\u00e9 d\u2019un SSD, un mini-PC basse consommation ou une machine virtuelle correctement dimensionn\u00e9e convient. Le point important n\u2019est pas seulement la puissance. La stabilit\u00e9 du stockage compte davantage. Une carte microSD sollicit\u00e9e en permanence finit souvent par devenir le maillon faible.<\/p>\n\n<p class=\"wp-block-paragraph\">Un ancien Raspberry Pi peut servir de serveur secondaire pour MQTT et Zigbee2MQTT. Cette s\u00e9paration a un int\u00e9r\u00eat : le serveur principal conserve les interfaces, les tableaux de bord et les sc\u00e9narios, tandis qu\u2019une seconde instance assure les services radio. Ce n\u2019est pas obligatoire. Deux machines impliquent deux alimentations, deux sauvegardes et davantage de r\u00e9glages r\u00e9seau. Pour un premier d\u00e9ploiement, une seule instance bien sauvegard\u00e9e est plus simple \u00e0 administrer.<\/p>\n\n<p class=\"wp-block-paragraph\">La configuration doit aussi tenir compte de l\u2019emplacement. Un coordinateur branch\u00e9 directement derri\u00e8re un mini-PC, coll\u00e9 \u00e0 un disque USB 3 ou \u00e0 un routeur Wi-Fi, peut subir des interf\u00e9rences sur la bande 2,4 GHz. Une rallonge USB de 50 cm \u00e0 1 m am\u00e9liore souvent la qualit\u00e9 radio. L\u2019antenne doit rester verticale, d\u00e9gag\u00e9e et plac\u00e9e si possible \u00e0 plus de 1 m du routeur Wi-Fi.<\/p>\n\n<p class=\"wp-block-paragraph\">Dans Home Assistant, commencer par cr\u00e9er un utilisateur non administrateur d\u00e9di\u00e9 \u00e0 MQTT. Depuis le menu des personnes et utilisateurs, il faut autoriser sa connexion puis d\u00e9finir un mot de passe long et unique. Un minimum raisonnable est de 14 caract\u00e8res, avec lettres, chiffres et caract\u00e8res sp\u00e9ciaux. Ce compte ne sert pas \u00e0 ouvrir l\u2019interface Home Assistant chaque jour. Il sert \u00e0 authentifier les \u00e9changes entre Zigbee2MQTT et Mosquitto.<\/p>\n\n<p class=\"wp-block-paragraph\">Cette pr\u00e9caution para\u00eet technique, mais elle \u00e9vite un d\u00e9faut fr\u00e9quent : un broker laiss\u00e9 accessible sans identifiants sur le r\u00e9seau domestique. M\u00eame sans ouverture volontaire vers Internet, une configuration n\u00e9glig\u00e9e peut permettre \u00e0 un appareil local compromis d\u2019envoyer des commandes ou de lire des \u00e9tats sensibles. Le principe est simple : limiter les droits et ne pas exposer MQTT sur la box internet.<\/p>\n\n<h3 class=\"wp-block-heading\">Choisir un coordinateur adapt\u00e9 au r\u00e9seau zigbee<\/h3>\n\n<p class=\"wp-block-paragraph\">Le coordinateur est la pi\u00e8ce centrale du r\u00e9seau zigbee. Les mod\u00e8les USB reposent sur plusieurs familles de puces. Les versions actuelles utilisant Ember, Texas Instruments ou Silicon Labs sont courantes, mais leur param\u00e9trage diff\u00e8re. Les adaptateurs r\u00e9cents demandent fr\u00e9quemment une d\u00e9claration de type <strong>ember<\/strong> et un d\u00e9bit de 115200 bauds dans Zigbee2MQTT.<\/p>\n\n<p class=\"wp-block-paragraph\">Un dongle USB avec antenne externe offre souvent une meilleure marge radio qu\u2019un petit adaptateur compact. Pour une installation \u00e9loign\u00e9e du serveur, un contr\u00f4leur Ethernet ou PoE peut \u00eatre pertinent. Il place l\u2019antenne au centre du logement sans prolonger l\u2019USB. Le fonctionnement et les crit\u00e8res de choix d\u2019un <a href=\"https:\/\/aes-montbrison.fr\/blog\/alarme-detection\/controleur-zigbee-slzb06m-matter\/\">contr\u00f4leur Zigbee compatible Matter<\/a> m\u00e9ritent alors d\u2019\u00eatre examin\u00e9s avant l\u2019achat.<\/p>\n\n<p class=\"wp-block-paragraph\"><strong>Le pi\u00e8ge :<\/strong> ne pas confondre coordinateur et routeur Zigbee. Le premier cr\u00e9e le r\u00e9seau. Une prise connect\u00e9e aliment\u00e9e en permanence peut ensuite \u00e9tendre sa port\u00e9e, mais elle ne remplace pas le coordinateur.<\/p>\n\n<p class=\"wp-block-paragraph\">Une pr\u00e9paration s\u00e9rieuse \u00e9vite les d\u00e9montages inutiles. Le mat\u00e9riel doit \u00eatre fix\u00e9, le port identifi\u00e9 et le compte MQTT cr\u00e9\u00e9 avant de lancer les services.<\/p>\n\n<figure class=\"is-provider-youtube is-type-video wp-block-embed wp-block-embed-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio\"><div class=\"wp-block-embed__wrapper\">\n<iframe loading=\"lazy\" title=\"TUTO Installation Home Assistant, Zigbee2MQTT &amp; Mosquitto 2025 - La bonne m\u00e9thode ! \ud83d\ude0e\" width=\"500\" height=\"281\" src=\"https:\/\/www.youtube.com\/embed\/YTEFZzly4zw?feature=oembed\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen><\/iframe>\n<\/div><\/figure>\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Installer_Mosquitto_Broker_et_connecter_MQTT_a_Home_Assistant\"><\/span>Installer Mosquitto Broker et connecter MQTT \u00e0 Home Assistant<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n<p class=\"wp-block-paragraph\">Le broker Mosquitto est le point de passage des messages MQTT. Dans Home Assistant OS, ouvrir <strong>Param\u00e8tres<\/strong>, puis <strong>Applications<\/strong>, et acc\u00e9der \u00e0 la boutique des applications. Une recherche sur \u00ab Mosquitto \u00bb fait appara\u00eetre le module officiel Mosquitto Broker. Il est pr\u00e9f\u00e9rable de choisir cette version maintenue dans l\u2019\u00e9cosyst\u00e8me Home Assistant plut\u00f4t qu\u2019un composant dont la provenance est incertaine.<\/p>\n\n<p class=\"wp-block-paragraph\">Apr\u00e8s l\u2019installation, deux options m\u00e9ritent d\u2019\u00eatre activ\u00e9es imm\u00e9diatement : <strong>Lancer au d\u00e9marrage<\/strong> et <strong>Chien de garde<\/strong>. La premi\u00e8re relance automatiquement le service apr\u00e8s un red\u00e9marrage de la machine. La seconde surveille le module et tente un red\u00e9marrage s\u2019il cesse de r\u00e9pondre. Cette surveillance ne remplace pas un diagnostic, mais elle \u00e9vite qu\u2019un service bloqu\u00e9 reste hors ligne jusqu\u2019\u00e0 la prochaine v\u00e9rification manuelle.<\/p>\n\n<p class=\"wp-block-paragraph\">Avant de d\u00e9marrer Mosquitto, renseigner l\u2019utilisateur MQTT cr\u00e9\u00e9 pr\u00e9c\u00e9demment. Selon la version de l\u2019interface, le module peut accepter une liste d\u2019identifiants dans sa zone de configuration ou utiliser les utilisateurs Home Assistant autoris\u00e9s. Le but est identique : Zigbee2MQTT doit se connecter au broker avec un compte d\u00e9di\u00e9, et non avec un acc\u00e8s anonyme.<\/p>\n\n<p class=\"wp-block-paragraph\">Le port MQTT standard est <strong>1883<\/strong>. Sur une installation supervis\u00e9e, Zigbee2MQTT communique habituellement avec le broker interne via l\u2019adresse <strong>mqtt:\/\/core-mosquitto:1883<\/strong>. Dans certains environnements, notamment apr\u00e8s une migration ou une installation particuli\u00e8re, <strong>mqtt:\/\/localhost:1883<\/strong> peut \u00eatre n\u00e9cessaire. Il ne faut pas changer cette valeur au hasard. Les journaux de Zigbee2MQTT indiqueront clairement une erreur de connexion, d\u2019authentification ou de r\u00e9solution de nom.<\/p>\n\n<p class=\"wp-block-paragraph\">Une fois Mosquitto lanc\u00e9, Home Assistant doit reconna\u00eetre l\u2019int\u00e9gration MQTT. Aller dans <strong>Param\u00e8tres<\/strong>, puis <strong>Appareils et services<\/strong>. Si MQTT est d\u00e9tect\u00e9, cliquer sur \u00ab Configurer \u00bb puis terminer l\u2019assistant. Cette \u00e9tape active l\u2019int\u00e9gration c\u00f4t\u00e9 Home Assistant. Sans elle, le broker peut fonctionner mais les entit\u00e9s publi\u00e9es par Zigbee2MQTT ne seront pas exploit\u00e9es correctement dans les tableaux de bord.<\/p>\n\n<h3 class=\"wp-block-heading\">Lire les journaux plut\u00f4t que recommencer toute l\u2019installation<\/h3>\n\n<p class=\"wp-block-paragraph\">Les journaux sont le premier outil de d\u00e9pannage. Un message \u00ab connection refused \u00bb renvoie souvent \u00e0 un identifiant, un mot de passe ou une adresse de broker incorrecte. Une erreur li\u00e9e au port 1883 peut signaler qu\u2019un autre service utilise d\u00e9j\u00e0 ce port. Un module qui red\u00e9marre en boucle peut avoir une configuration YAML mal indent\u00e9e ou une valeur plac\u00e9e dans la mauvaise rubrique.<\/p>\n\n<p class=\"wp-block-paragraph\">Claire et Malik ont rencontr\u00e9 un cas classique : Mosquitto \u00e9tait install\u00e9, mais l\u2019int\u00e9gration MQTT restait en attente dans Home Assistant. Leur r\u00e9seau Zigbee n\u2019\u00e9tait pas en cause. Apr\u00e8s l\u2019activation de l\u2019int\u00e9gration dans \u00ab Appareils et services \u00bb, les appareils publi\u00e9s sont apparus normalement. Cette v\u00e9rification prend moins de 2 minutes et \u00e9vite de r\u00e9initialiser les \u00e9quipements radio.<\/p>\n\n<p class=\"wp-block-paragraph\">Il est prudent de ne pas exposer le port 1883 vers Internet. L\u2019acc\u00e8s distant \u00e0 Home Assistant doit passer par une solution s\u00e9curis\u00e9e, avec authentification forte et mises \u00e0 jour suivies. MQTT est con\u00e7u pour le transport de messages. Il n\u2019est pas un portail public \u00e0 ouvrir par d\u00e9faut.<\/p>\n\n<p class=\"wp-block-paragraph\"><strong>\u00c0 retenir :<\/strong> un broker bien configur\u00e9 est discret. Il doit d\u00e9marrer seul, accepter uniquement les comptes pr\u00e9vus et laisser des journaux suffisamment clairs pour diagnostiquer un incident.<\/p>\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Installer_Zigbee2MQTT_et_declarer_le_port_du_coordinateur_Zigbee\"><\/span>Installer Zigbee2MQTT et d\u00e9clarer le port du coordinateur Zigbee<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n<p class=\"wp-block-paragraph\">Zigbee2MQTT n\u2019appara\u00eet pas toujours dans les applications officielles de Home Assistant. Il faut alors ajouter son d\u00e9p\u00f4t maintenu par le projet. Dans <strong>Param\u00e8tres<\/strong>, puis <strong>Applications<\/strong>, ouvrir la boutique, utiliser le menu \u00e0 trois points et s\u00e9lectionner les d\u00e9p\u00f4ts. Ajouter l\u2019adresse <strong>https:\/\/github.com\/zigbee2mqtt\/hassio-zigbee2mqtt<\/strong>, puis actualiser la page si le nouveau catalogue n\u2019est pas visible imm\u00e9diatement.<\/p>\n\n<p class=\"wp-block-paragraph\">Deux \u00e9ditions peuvent \u00eatre propos\u00e9es : la version stable et l\u2019\u00e9dition Edge. La version Edge sert \u00e0 tester des \u00e9volutions r\u00e9centes. Elle peut r\u00e9soudre un souci de compatibilit\u00e9 tr\u00e8s pr\u00e9cis, mais elle n\u2019est pas le bon choix pour un logement o\u00f9 l\u2019on attend des automatismes r\u00e9guliers. La version stable est pr\u00e9f\u00e9rable dans la majorit\u00e9 des cas.<\/p>\n\n<p class=\"wp-block-paragraph\">Installer Zigbee2MQTT, puis activer trois options : lancement au d\u00e9marrage, chien de garde et affichage dans la barre lat\u00e9rale. La derni\u00e8re n\u2019influe pas sur la fiabilit\u00e9 technique. Elle rend simplement l\u2019interface de gestion accessible sans chercher le module dans les menus. Ne pas d\u00e9marrer tout de suite. Il faut d\u2019abord renseigner le broker et le coordinateur.<\/p>\n\n<p class=\"wp-block-paragraph\">Dans la partie MQTT de la configuration, indiquer l\u2019adresse du serveur, le nom d\u2019utilisateur, le mot de passe et un topic de base, par exemple <strong>zigbee2mqtt<\/strong>. Ce topic est le pr\u00e9fixe sous lequel les \u00e9tats des appareils seront publi\u00e9s. Il est pr\u00e9f\u00e9rable de conserver un nom court et explicite. \u00c9viter les espaces, les accents et les noms impr\u00e9cis tels que \u00ab test \u00bb.<\/p>\n\n<p class=\"wp-block-paragraph\">La seconde donn\u00e9e essentielle est le chemin du p\u00e9riph\u00e9rique s\u00e9rie. Dans Home Assistant, ouvrir <strong>Param\u00e8tres<\/strong>, <strong>Syst\u00e8me<\/strong>, puis <strong>Mat\u00e9riel<\/strong>. Le coordinateur doit \u00eatre branch\u00e9 avant cette op\u00e9ration. La liste affiche souvent un chemin tel que <strong>\/dev\/ttyUSB0<\/strong> ou <strong>\/dev\/ttyACM0<\/strong>. Ce chemin peut changer si plusieurs p\u00e9riph\u00e9riques USB sont d\u00e9branch\u00e9s, ajout\u00e9s ou red\u00e9marr\u00e9s.<\/p>\n\n<p class=\"wp-block-paragraph\">La pratique la plus s\u00fbre consiste \u00e0 utiliser, quand il est disponible, un chemin stable dans <strong>\/dev\/serial\/by-id\/<\/strong>. Il identifie le mat\u00e9riel plut\u00f4t que sa position temporaire. C\u2019est un d\u00e9tail important : un port qui passe de ttyUSB0 \u00e0 ttyUSB1 peut emp\u00eacher Zigbee2MQTT de red\u00e9marrer apr\u00e8s une maintenance pourtant banale.<\/p>\n\n<h3 class=\"wp-block-heading\">Adapter la configuration au mod\u00e8le de cl\u00e9 radio<\/h3>\n\n<p class=\"wp-block-paragraph\">Le bloc s\u00e9rie doit correspondre au mat\u00e9riel. Beaucoup de cl\u00e9s modernes utilisent l\u2019adaptateur <strong>ember<\/strong> avec <strong>baudrate: 115200<\/strong>. Certains anciens mod\u00e8les n\u00e9cessitent un autre adaptateur. Il faut consulter la documentation propre au coordinateur avant de modifier ces lignes. Copier une configuration destin\u00e9e \u00e0 une autre puce est une source fr\u00e9quente d\u2019\u00e9chec au d\u00e9marrage.<\/p>\n\n<p class=\"wp-block-paragraph\">Un exemple de logique de configuration comprend l\u2019adresse MQTT, les identifiants, le topic et le bloc s\u00e9rie avec le port stable. Les mots de passe ne doivent jamais \u00eatre copi\u00e9s dans une capture publi\u00e9e sur un forum ou envoy\u00e9e sans pr\u00e9caution \u00e0 un tiers. Une capture des journaux doit masquer les donn\u00e9es sensibles.<\/p>\n\n<p class=\"wp-block-paragraph\">Le choix du mat\u00e9riel m\u00e9rite \u00e9galement une v\u00e9rification de compatibilit\u00e9. Le dossier sur le <a href=\"https:\/\/aes-montbrison.fr\/blog\/alarme-detection\/dongle-zigbee-sonoff-matter\/\">dongle Zigbee Sonoff et Matter<\/a> aide \u00e0 distinguer les usages Zigbee, Thread et les limites d\u2019un m\u00eame adaptateur lorsqu\u2019il faut choisir un r\u00f4le radio unique.<\/p>\n\n<p class=\"wp-block-paragraph\">Apr\u00e8s l\u2019enregistrement, d\u00e9marrer Mosquitto en premier, puis Zigbee2MQTT. Ouvrir le journal de ce dernier. Si le coordinateur est d\u00e9tect\u00e9 et que la connexion MQTT est valid\u00e9e, l\u2019interface Zigbee2MQTT devient accessible dans la barre lat\u00e9rale de Home Assistant.<\/p>\n\n<p class=\"wp-block-paragraph\"><strong>Le bon ordre r\u00e9duit les erreurs :<\/strong> broker op\u00e9rationnel, int\u00e9gration MQTT active, port radio stable, puis d\u00e9marrage de Zigbee2MQTT.<\/p>\n\n<figure class=\"is-provider-youtube is-type-video wp-block-embed wp-block-embed-youtube wp-embed-aspect-16-9 wp-has-aspect-ratio\"><div class=\"wp-block-embed__wrapper\">\n<iframe loading=\"lazy\" title=\"Installation et Configuration de Zigbee2MQTT sur Home Assistant (Guide Complet)\" width=\"500\" height=\"375\" src=\"https:\/\/www.youtube.com\/embed\/KA4XvVhyCtE?feature=oembed\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen><\/iframe>\n<\/div><\/figure>\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Appairer_les_appareils_et_construire_une_automatisation_domotique_fiable\"><\/span>Appairer les appareils et construire une automatisation domotique fiable<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n<p class=\"wp-block-paragraph\">Lorsque Zigbee2MQTT est fonctionnel, l\u2019appairage devient la phase visible de l\u2019installation. Dans son interface, activer l\u2019autorisation d\u2019association pendant une dur\u00e9e limit\u00e9e, par exemple 2 \u00e0 5 minutes. Mettre ensuite le capteur, la prise ou l\u2019ampoule en mode appairage selon la proc\u00e9dure du fabricant. En quelques secondes, l\u2019\u00e9quipement doit appara\u00eetre avec un nom et plusieurs \u00e9tats exploitables.<\/p>\n\n<p class=\"wp-block-paragraph\">Il est recommand\u00e9 de renommer chaque appareil imm\u00e9diatement. \u00ab Capteur porte entr\u00e9e \u00bb, \u00ab prise salon \u00bb ou \u00ab temp\u00e9rature chambre Lina \u00bb sont plus utiles que les identifiants techniques g\u00e9n\u00e9r\u00e9s automatiquement. Une maison \u00e9quip\u00e9e de 30 objets devient difficile \u00e0 maintenir si les noms sont incompr\u00e9hensibles. Le nommage facilite aussi les recherches lors d\u2019une panne ou d\u2019une modification de sc\u00e9nario.<\/p>\n\n<p class=\"wp-block-paragraph\">Le r\u00e9seau zigbee repose sur un maillage. Les appareils aliment\u00e9s en permanence, comme les prises et ampoules compatibles routeur, relaient les messages. Les capteurs sur piles sont g\u00e9n\u00e9ralement des terminaux : ils transmettent, mais ne renforcent pas la couverture. Dans une maison \u00e0 \u00e9tage, placer deux ou trois routeurs r\u00e9partis entre le coordinateur et les zones \u00e9loign\u00e9es est souvent plus efficace qu\u2019acheter une antenne plus puissante.<\/p>\n\n<p class=\"wp-block-paragraph\">Pour int\u00e9grer un appareil \u00e9loign\u00e9, Zigbee2MQTT permet dans certains cas de choisir un routeur pr\u00e9cis pendant l\u2019association. Cette fonction est utile dans un garage, une d\u00e9pendance attenante ou une pi\u00e8ce situ\u00e9e derri\u00e8re plusieurs murs porteurs. Elle ne contourne pas les limites physiques. Un mur en b\u00e9ton arm\u00e9, une baie m\u00e9tallique ou un tableau \u00e9lectrique peut r\u00e9duire fortement la port\u00e9e.<\/p>\n\n<h3 class=\"wp-block-heading\">Construire des sc\u00e9narios utiles sans multiplier les alertes<\/h3>\n\n<p class=\"wp-block-paragraph\">Une automatisation doit r\u00e9pondre \u00e0 une situation r\u00e9elle. Prenons un d\u00e9tecteur d\u2019ouverture pos\u00e9 sur une fen\u00eatre de cuisine. Une r\u00e8gle simple peut couper le chauffage de cette pi\u00e8ce apr\u00e8s 10 minutes d\u2019ouverture, puis le r\u00e9tablir \u00e0 la fermeture. Cette logique limite le gaspillage sans d\u00e9clencher de notifications inutiles.<\/p>\n\n<p class=\"wp-block-paragraph\">Autre exemple : une prise routeur Zigbee dans le couloir alimente une veilleuse. Entre 22 h et 6 h, le mouvement d\u00e9tect\u00e9 dans le passage lance l\u2019\u00e9clairage \u00e0 20 % durant 90 secondes. La luminosit\u00e9 mod\u00e9r\u00e9e \u00e9vite l\u2019\u00e9blouissement et la consommation reste faible. Si le capteur ne r\u00e9pond plus, l\u2019automatisation doit \u00e9chouer sans bloquer d\u2019autres fonctions de la maison.<\/p>\n\n<p class=\"wp-block-paragraph\">Pour les \u00e9quipements li\u00e9s \u00e0 la s\u00e9curit\u00e9 domestique, la prudence est n\u00e9cessaire. Un capteur d\u2019ouverture peut compl\u00e9ter un syst\u00e8me d\u2019alarme en envoyant une information vers Home Assistant. Il ne doit pas \u00eatre pr\u00e9sent\u00e9 comme une alarme certifi\u00e9e. Les d\u00e9tecteurs destin\u00e9s \u00e0 une protection contre l\u2019intrusion doivent respecter les exigences du syst\u00e8me auquel ils sont rattach\u00e9s, notamment lorsqu\u2019un assureur ou un contrat professionnel impose une certification sp\u00e9cifique.<\/p>\n\n<p class=\"wp-block-paragraph\">La domotique peut aussi simplifier le quotidien des proches \u00e2g\u00e9s : une lumi\u00e8re de circulation, une alerte de temp\u00e9rature anormale ou un rappel discret. Elle ne se substitue pas \u00e0 un dispositif de t\u00e9l\u00e9assistance adapt\u00e9 lorsque l\u2019\u00e9tat de sant\u00e9 l\u2019exige. L\u2019int\u00e9r\u00eat est d\u2019ajouter des rep\u00e8res pratiques, pas de confier \u00e0 une automatisation une responsabilit\u00e9 qu\u2019elle ne peut garantir.<\/p>\n\n<p class=\"wp-block-paragraph\"><strong>\u00c0 retenir :<\/strong> un bon sc\u00e9nario est compr\u00e9hensible en une phrase, utile chaque semaine et d\u00e9sactivable facilement si les habitudes du foyer changent.<\/p>\n\n<h2 class=\"wp-block-heading\"><span class=\"ez-toc-section\" id=\"Sauvegarder_MQTT_et_Zigbee2MQTT_pour_eviter_de_reconstruire_le_reseau\"><\/span>Sauvegarder MQTT et Zigbee2MQTT pour \u00e9viter de reconstruire le r\u00e9seau<span class=\"ez-toc-section-end\"><\/span><\/h2>\n\n<p class=\"wp-block-paragraph\">La sauvegarde est souvent oubli\u00e9e jusqu\u2019au premier incident. Or, le r\u00e9seau zigbee poss\u00e8de une cl\u00e9 de s\u00e9curit\u00e9 et une base d\u2019appareils qui ne se recr\u00e9ent pas automatiquement apr\u00e8s un changement de serveur. Sans copie fiable, remplacer un disque, restaurer une machine ou migrer vers un mini-PC peut imposer de r\u00e9appairer chaque module. Avec 25 appareils, cette op\u00e9ration peut repr\u00e9senter 1 \u00e0 3 heures, parfois davantage si certains capteurs sont difficiles d\u2019acc\u00e8s.<\/p>\n\n<p class=\"wp-block-paragraph\">Home Assistant propose des sauvegardes compl\u00e8tes et partielles. Une sauvegarde compl\u00e8te inclut la configuration, les modules, les donn\u00e9es et les r\u00e9glages n\u00e9cessaires \u00e0 une restauration coh\u00e9rente. Elle doit \u00eatre r\u00e9alis\u00e9e avant toute mise \u00e0 jour importante de Home Assistant, de Mosquitto ou de Zigbee2MQTT. Une fr\u00e9quence hebdomadaire convient \u00e0 un syst\u00e8me stable. Apr\u00e8s l\u2019ajout de plusieurs appareils ou la cr\u00e9ation d\u2019automatismes importants, une sauvegarde manuelle suppl\u00e9mentaire est justifi\u00e9e.<\/p>\n\n<p class=\"wp-block-paragraph\">Conserver la sauvegarde sur la m\u00eame carte SD ou le m\u00eame SSD ne suffit pas. En cas de panne mat\u00e9rielle, le fichier dispara\u00eet avec le syst\u00e8me. Une copie vers un NAS, un espace chiffr\u00e9 ou un support USB d\u00e9branch\u00e9 apr\u00e8s usage offre une meilleure protection. La r\u00e8gle pratique est de disposer d\u2019au moins deux copies, dont une hors de la machine Home Assistant.<\/p>\n\n<p class=\"wp-block-paragraph\">Les mises \u00e0 jour doivent \u00eatre pr\u00e9par\u00e9es. Lire les notes de version de Zigbee2MQTT avant une \u00e9volution majeure. Certaines modifications touchent les adaptateurs radio, les conventions de configuration ou la compatibilit\u00e9 d\u2019appareils. Attendre quelques jours avant d\u2019installer une version importante est raisonnable pour un syst\u00e8me domestique stable. Il n\u2019y a aucun b\u00e9n\u00e9fice \u00e0 appliquer une mise \u00e0 jour le jour m\u00eame si l\u2019installation fonctionne correctement.<\/p>\n\n<p class=\"wp-block-paragraph\">Un contr\u00f4le mensuel prend moins de 15 minutes : consulter les journaux, v\u00e9rifier les appareils indisponibles, tester un capteur sur piles, examiner l\u2019\u00e9tat des sauvegardes et s\u2019assurer que la rallonge USB est bien fix\u00e9e. Ce contr\u00f4le pr\u00e9ventif est plus utile qu\u2019une accumulation d\u2019automatisations complexes jamais relues.<\/p>\n\n<p class=\"wp-block-paragraph\">La disponibilit\u00e9 locale reste un avantage, mais elle implique une responsabilit\u00e9 simple : maintenir le serveur. Les utilisateurs qui pr\u00e9f\u00e8rent une approche progressive peuvent commencer par les bases gr\u00e2ce au guide d\u2019<a href=\"https:\/\/aes-montbrison.fr\/blog\/alarme-detection\/home-assistant-initiation\/\">initiation \u00e0 Home Assistant<\/a>, puis ajouter MQTT et Zigbee2MQTT lorsque les sauvegardes et la structure de la domotique sont comprises.<\/p>\n\n<p class=\"wp-block-paragraph\"><strong>Le bon r\u00e9flexe :<\/strong> cr\u00e9er maintenant une sauvegarde compl\u00e8te de Home Assistant, la copier hors de la machine, puis noter le chemin stable du coordinateur Zigbee dans un document conserv\u00e9 avec les identifiants de r\u00e9cup\u00e9ration.<\/p>\n\n<h3>Faut-il une connexion internet pour utiliser Zigbee2MQTT ?<\/h3>\n<p>Non. Les \u00e9changes entre le coordinateur, Zigbee2MQTT, MQTT et Home Assistant peuvent rester locaux. Internet est surtout utile pour les mises \u00e0 jour, l\u2019acc\u00e8s distant choisi par le foyer et certaines int\u00e9grations externes.<\/p>\n<h3>Pourquoi Zigbee2MQTT ne d\u00e9marre-t-il pas apr\u00e8s une mise \u00e0 jour ?<\/h3>\n<p>Les causes les plus courantes sont un port USB modifi\u00e9, un adaptateur mal d\u00e9clar\u00e9, des identifiants MQTT incorrects ou une \u00e9volution de configuration. Le journal du module donne g\u00e9n\u00e9ralement l\u2019indication utile avant toute r\u00e9installation.<\/p>\n<h3>Peut-on utiliser plusieurs coordinateurs Zigbee avec la m\u00eame installation ?<\/h3>\n<p>Oui, mais chaque coordinateur g\u00e8re son propre r\u00e9seau Zigbee et demande une instance adapt\u00e9e de Zigbee2MQTT. Pour un logement classique, un seul coordinateur correctement plac\u00e9 et quelques routeurs suffisent g\u00e9n\u00e9ralement.<\/p>\n<h3>Le chien de garde Home Assistant remplace-t-il une sauvegarde ?<\/h3>\n<p>Non. Le chien de garde tente de relancer un service bloqu\u00e9. Il ne restaure ni les appareils, ni la cl\u00e9 r\u00e9seau, ni les automatisations apr\u00e8s une panne de stockage ou une erreur de configuration.<\/p>\n\n","protected":false},"excerpt":{"rendered":"<p>En bref Pourquoi associer MQTT et Zigbee2MQTT dans Home Assistant Une installation domotique devient vite confuse lorsque chaque objet connect\u00e9 d\u00e9pend d\u2019une application, d\u2019un compte en ligne ou d\u2019une passerelle diff\u00e9rente. L\u2019association de Home Assistant, MQTT et Zigbee2MQTT propose une autre approche : les appareils communiquent sur le r\u00e9seau local et les donn\u00e9es restent pilotables [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":556,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[19],"tags":[],"class_list":["post-555","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-actualites"],"_links":{"self":[{"href":"https:\/\/aes-montbrison.fr\/blog\/wp-json\/wp\/v2\/posts\/555","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/aes-montbrison.fr\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/aes-montbrison.fr\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/aes-montbrison.fr\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/aes-montbrison.fr\/blog\/wp-json\/wp\/v2\/comments?post=555"}],"version-history":[{"count":2,"href":"https:\/\/aes-montbrison.fr\/blog\/wp-json\/wp\/v2\/posts\/555\/revisions"}],"predecessor-version":[{"id":559,"href":"https:\/\/aes-montbrison.fr\/blog\/wp-json\/wp\/v2\/posts\/555\/revisions\/559"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/aes-montbrison.fr\/blog\/wp-json\/wp\/v2\/media\/556"}],"wp:attachment":[{"href":"https:\/\/aes-montbrison.fr\/blog\/wp-json\/wp\/v2\/media?parent=555"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/aes-montbrison.fr\/blog\/wp-json\/wp\/v2\/categories?post=555"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/aes-montbrison.fr\/blog\/wp-json\/wp\/v2\/tags?post=555"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}