Installer et configurer Zigbee2MQTT et MQTT sous Home Assistant

/ Tutos / Par

mqtt mini

Dans cette suite de ma précédente vidéo consacrée à l’installation de Home Assistant via Docker, nous allons passer à l’étape suivante : faire fonctionner Zigbee2MQTT afin d’ajouter et contrôler vos appareils Zigbee — ou Matter — dans Home Assistant.

Même si la vidéo précédente n’a pas rencontré un grand succès, je continue la série afin que vous puissiez mettre en place un système domotique propre, durable et surtout évolutif.

🏠 Choisir la bonne technologie : Zigbee, Matter… ou les deux ?

Quand on débute en domotique, la première étape incontournable est de choisir le standard de communication des appareils. Aujourd’hui, les deux plus pertinents sont Zigbee et Matter.

✔ Pourquoi Zigbee ?

  • Très répandu

  • Appareils peu coûteux

  • Stable et bien supporté

✔ Pourquoi Matter ?

  • La norme qui devient un standard universel

  • Fonctionne en local

  • Compatible avec de plus en plus d’appareils

Si vous démarrez maintenant, l’idéal est de choisir une clé USB compatible Zigbee et Matter. De nombreux modèles Sonoff peuvent le devenir via mises à jour.

🔧 Choisir et flasher sa clé USB Zigbee/Matter

J’utilise depuis longtemps une clé Sonoff Zigbee 3.0 basée sur une puce EFR32MG21. Amazon ne mentionne pas la compatibilité Matter, mais des firmwares mis à jour permettent aujourd’hui de rendre cette clé multiprotocole.

Cependant, une version plus récente — basée sur l’EFR32MG24 — offre :

  • plus de mémoire,

  • plus de puissance,

  • une meilleure compatibilité future.

🧩 Mise à jour du firmware (Zigbee ou multiprotocole)

Des sites très bien faits expliquent la procédure pas à pas, avec même des vidéos. La mise à jour peut se faire directement depuis le navigateur, ce qui simplifie énormément l’opération.

🖥 Préparation du serveur : Docker + OMV

Mon installation fonctionne sur un serveur Debian avec OpenMediaVault (OMV). Avant de continuer :

  1. Je branche la clé USB Zigbee sur un port (avant ou arrière).

  2. Je redémarre le serveur.

  3. Je me connecte via SSH (PuTTY) pour identifier correctement la clé.

Cette étape permet ensuite de créer une règle persistante, afin que la clé garde la même adresse même en cas de changement de port USB ou de machine.

🏷 Trouver et fixer le nom de la clé USB

Dans PuTTY, une commande permet d’afficher les informations complètes du périphérique Zigbee et notamment son identifiant unique.

On copie ensuite uniquement la partie nécessaire, qui servira dans notre fichier docker-compose de Zigbee2MQTT.

L’objectif est clair :
🔹 pouvoir déplacer la clé ou changer de PC sans casser la configuration.

📁 Préparation des dossiers et permissions

Sous OMV, il faut toujours créer les dossiers de volumes avant de lancer les containers pour éviter les erreurs de permissions.
On crée donc :

  • un dossier pour MQTT

  • un dossier pour Zigbee2MQTT

  • un fichier mosquitto.conf minimal mais nécessaire

Puis :

  • on applique les bons droits (chown, chmod)

  • on valide que l’UID et le GID correspondent au service Docker

🧱 Installation des containers MQTT et Zigbee2MQTT

L’installation se fait via l’interface Docker/Compose d’OpenMediaVault.

1️⃣ Installer Mosquitto MQTT

services:
  mosquitto:
    image: eclipse-mosquitto
    container_name: mqtt
    restart: always
    volumes:
      - /docker/config/mqtt/config:/mosquitto/config
      - /docker/config/mqtt/data:/mosquitto/data
      - /docker/config/mqtt/log:/mosquitto/log
      - /etc/localtime:/etc/localtime:ro
    ports:
      - 1883:1883
      - 9001:9001

2️⃣ Installer Zigbee2MQTT

Idem :

  • on colle le compose

  • on indique le bon chemin du device USB (celui récupéré via PuTTY)

  • on déploie

En quelques secondes, les deux containers tournent.
services:
zigbee2mqtt:
  container_name: zigbee2mqtt
  image: koenkk/zigbee2mqtt
  restart: unless-stopped
  volumes:
    - /docker/config/zigbee2mqtt:/app/data
    - /run/udev:/run/udev:ro
  ports:
  # Frontend port
    - 8080:8080
  environment:
    - TZ=Europe/Paris
  devices:
    - /dev/serial/by-id/usb-Itead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_V2_44b15bee7b12ef11917a6db8bf9df066-if00-port0:/dev/ttyUSB0

🔗 Liaison MQTT ↔ Home Assistant

Dans Home Assistant :

  1. Paramètres > Appareils & Services

  2. Ajouter une intégration

  3. Choisir MQTT

  4. Indiquer l’adresse du broker (souvent 192.168.1.xx)

  5. Valider (sans login si non configuré)

Home Assistant est maintenant prêt à recevoir les messages Zigbee.

🌐 Configuration de Zigbee2MQTT

En allant sur :                      http://192.168.1.xx:8080

Vous accédez à l’interface Web.

Les paramètres essentiels :

  • l’adresse du broker MQTT

  • la clé USB

  • l’activation de l’interface web

On valide, et l’interface redémarre.

🔄 Appairage des appareils Zigbee

L’écran affiche pour l’instant aucun appareil : normal.

Pour ajouter un appareil :

  1. Passer Zigbee2MQTT en mode permit join

  2. Mettre l’appareil en mode appairage (généralement : appui long jusqu’au clignotement)

Après quelques secondes, l’appareil apparaît dans la liste.

📡 Attention au maillage Zigbee

Zigbee fonctionne comme un réseau maillé :

  • les appareils alimentés (prises, modules encastrés…) = routeurs

  • les appareils à piles = terminaux

Plus vous avez de routeurs, plus votre réseau sera robuste et étendu.

🧭 Conclusion

Vous avez maintenant :

  • un broker MQTT fonctionnel,

  • Zigbee2MQTT installé,

  • une clé USB configurée proprement,

  • Home Assistant capable de dialoguer avec le tout.

À partir de là, il ne vous reste plus qu’à appairer vos appareils et commencer l’automatisation de votre maison.

🎥 La vidéo complète

Retrouvez la démo détaillée et toutes les étapes en images sur ma chaîne :

Abonnement
Abonnement
Retour en haut