Matter sur Docker et Home Assistant

Dernière mise à jour le 24 mars 2024

Découvrez comment installer Matter sur Docker et Home Assistant !

Prérequis
Installation

Qu’est ce que Matter ?

https://fr.wikipedia.org/wiki/Matter_(standard)

Pour commencer, bonjour et bienvenue sur mon blog Technologie Geek ! Voyons ensemble comment déployer Matter sur Docker et Home Assistant. Matter est un protocole de connectivité IoT (Internet des objets) ouvert et universel vous permettant de simplifier l’interopérabilité de vos appareils domotiques. Il vise également à créer un écosystème où vos appareils de différentes marques peuvent communiquer de manière transparente.

Ensuite, Matter vous va vous permettre à terme de n’utiliser plus qu’un seul protocole de communication. Vous pourrez aussi gérer tous vos modules avec une seule application. Matter vous offre une sécurité renforcée, vous garantissant que les données échangées entre vos appareils sont protégées. De plus, il prend en charge divers types de connexions comme Ethernet, WiFi mais aussi Thread et Bluetooth.

Tout d’abord, vous devez disposer d’une installation de Home Assistant sur Docker ainsi que l’application HA officielle sur votre téléphone (l’ajout de périphériques ce faisant que par elle). Ensuite, vous devez avoir un module compatible Matter, pour ma part j’utilise un esp32 flasher avec Tasmota (les esp8266 ne sont pas compatibles). Enfin, Home Assistant, l’application ainsi que vos modules doivent être sur le même réseau.

Déploiement de Matter sur Docker et Home Assistant !

Présentation
Prérequis

1. Installation de matter-server

Pour débuter, rendez vous dans Portainer, puis dans « Stacks » et enfin cliquer sur « Add stack ».

Ensuite, dans « Name » donner lui un nom, puis copier et coller le code ci-dessous. Vous pouvez ajuster le volume « /data/ » selon votre installation puis cliquer sur « Deploy the stack ».

version: "3.8"
services:
  matter-server:
    image: ghcr.io/home-assistant-libs/python-matter-server:stable
    container_name: matter-server
    restart: unless-stopped
    network_mode: host
    security_opt:
      - apparmor:unconfined
    volumes:
      - /opt/docker/matter-server/data:/data/
      - /run/dbus:/run/dbus:ro

2. Matter sur home assistant

Maintenant, vous devez installer Matter sur Home Assistant puis le connecter à votre conteneur. Pour cela, aller dans « Paramètres/Appareils et Services », cliquer sur « AJOUTER UNE INTEGRATION » et rechercher « Matter (BETA) ». Une fenêtre va s’ouvrir, vous devez remplacer « localhost » par l’adresse IP de votre serveur Docker.

3. Ajout de votre module Matter avec l’application Home Assistant

Premièrement, vous devez ouvrir votre application HA, puis aller dans « Paramètres/Appareils et Services ». En bas de la fenêtre il faut que vous sélectionniez « Appareils », « AJOUTER UNE INTEGRATION » et enfin cliquer sur « Ajouter un appareil Matter ». Pour connecter votre module sur Matter et l’ajouter à Home Assistant vous disposez de deux solutions :

Flasher le code barre.
Copier manuellement le code d’appairage.

Pour finir, il ne vous reste plus qu’à patienter et vous devriez voir apparaitre un nouvel appareil Matter dans Home Assistant !

4 réponses à “Matter sur Docker et Home Assistant”

bofih
3 décembre 2023
Hello, merci pour ce tuto,
Peux tu expliquer la partie :
Ensuite, vous devez avoir un module compatible Matter, pour ma part j’utilise un esp32 flasher avec Tasmota (les esp8266 ne sont pas compatibles).
Est-ce possible de le faire via esphome ?
Est-ce que tu as une référence d’esp32 ?
Merci d’avance.
Répondre
1. Stéphane
  3 décembre 2023
  Bonjour,
  A ma connaissance ESPHome ne gère par le protocole Matter.
  Un exemple de module Matter :
  https://www.domadoo.fr/fr/produits/6783-sonoff-module-connecte-onoff-matter-10a-minir4m.html
  Un lien vers un ESP32 :
  https://www.amazon.fr/AZDelivery-Development-successeur-Compatible-incluant/dp/B071P98VTG/ref=asc_df_B071P98VTG/?tag=googshopfr-21&linkCode=df0&hvadid=194939354820&hvpos=&hvnetw=g&hvrand=8158503360280110023&hvpone=&hvptwo=&hvqmt=&hvdev=c&hvdvcmdl=&hvlocint=&hvlocphy=9109647&hvtargid=pla-367709801435&mcid=3c2144aa0c7c390d949675158d869029&th=1
  Répondre
Thierry
14 janvier 2024
Bonjour,
Le déploiement m’indique que /opt/docker/matter-server/data n’existe pas…
Connaissez vous le chemin qui est maintenant utilisé ? Voici ma LOG :
Pull complete matter-server Pulled Container matter-server Creating Container matter-server Created Container matter-server Starting Error response from daemon: Bind mount failed: ‘/opt/docker/matter-server/data’ does not exists
Merci,
Thierry
Répondre
1. Stéphane
  14 janvier 2024
  Bonjour Thierry,
  Essaye avec ce code :
  version: "3.8" services: matter-server: image: ghcr.io/home-assistant-libs/python-matter-server:stable container_name: matter-server restart: unless-stopped network_mode: host security_opt: - apparmor:unconfined volumes: - data:/data/ - /run/dbus:/run/dbus:ro volumes: data:
  Attention à la syntaxe yaml, wordpress ne me permet pas de la respecter !
  Répondre