Matter: Progress update!

[pierre-gilles]

Hello everyone

I wanted to give you a quick update on the development of the Matter integration in Gladys.

Features already supported

The integration is progressing well and currently handles the following device types and features:

• On/Off: plugs, lights, air conditioners, heating, fans, etc.
• Lights: brightness and color control
• Roller shutters / curtains
• Thermostats: setting the target temperature
• Air conditioners: target temperature
• Motion sensors
• Light sensors
• Temperature sensors
• Humidity sensors

Extended compatibility with Matterbridge

Thanks to the open-source project Matterbridge, this integration is not limited to native Matter devices: it also allows controlling Shelly, Somfy Tahoma, and many others.

@mutmut and @Terdious have already tested this setup successfully.

---

Tested Matter devices

Here are some examples of Thread-compatible Matter devices I was able to test successfully:

• Nanoleaf Color LED Bulb E27 Matter Thread
• Eve Energy Thread smart plug
• Eve Motion Thread motion sensor

These devices work with Thread: you’ll therefore need a Thread Border Router (Apple TV 4K, Google Home, or a compatible Alexa speaker).

However, devices already connected via the network, such as Matterbridge, or Wi‑Fi plugs, do not need a Thread Border Router.

Matter is an application-layer protocol, whereas Thread is a radio protocol and is a direct competitor to Zigbee, Bluetooth, and Z-Wave.

---

Test the Gladys + Matter integration

Here is the Docker command to run a Gladys instance with the matter-integration branch:

sudo docker run -d \
  --log-driver json-file \
  --log-opt max-size=10m \
  --cgroupns=host \
  --restart=always \
  --privileged \
  --network=host \
  --name gladys \
  -e NODE_ENV=production \
  -e SERVER_PORT=80 \
  -e TZ=Europe/Paris \
  -e SQLITE_FILE_PATH=/var/lib/gladysassistant/gladys-production.db \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v /var/lib/gladysassistant:/var/lib/gladysassistant \
  -v /dev:/dev \
  -v /run/udev:/run/udev:ro \
  gladysassistant/gladys:matter-integration

---

Test Matterbridge

Here’s how I ran Matterbridge on my mini-PC (as root):

1. Create a folder for Matterbridge:

mkdir -p /root/matterbridge/docker_data

2. Run Matterbridge in Docker:

sudo docker run --name matterbridge \
  -v /root/matterbridge/docker_data/Matterbridge:/root/Matterbridge \
  -v /root/matterbridge/docker_data/.matterbridge:/root/.matterbridge \
  --network host --restart always -d \
  luligu/matterbridge:latest

3. Retrieve the URL of the Matterbridge interface (shown in the logs docker logs matterbridge, e.g.: http://192.168.0.99:8283/), and copy the pairing code:

5. Paste this code into Gladys’s Matter integration:

7. Once paired, you’ll find all your Matter devices in the Devices tab, ready to be added to Gladys!

---

Your feedback is welcome

I’m looking for testers for this integration, especially those who were waiting for Shelly or Somfy compatibility!

Feel free to test it at home and give me your feedback here on the forum.

Thanks everyone for your support!

[pierre-gilles]

I made a post on Reddit /r/homeautomation to ask for feedback on this integration, hoping to get international responses

The Reddit post