Part 5 - Install Matter Server using docker image via docker run

How I Added a Matter Device to Home Assistant - Step By Step 

 

If you run Home Assistant in a container, you can run a Docker image of the Matter server.

Guide:https://github.com/home-assistant-libs/python-matter-server

Pre-Requisites

Make sure there is a Thread border router device present in your home network.

Speakers: HomePod (2nd generation), HomePod mini

TVs: Apple TV 4K (3rd generation) Wi-Fi + Ethernet, Apple TV 4K (2nd generation)

Make sure you run the container on the host network.

The host network interface needs IPv6 support enabled.

The host network interface needs IPv6 support enabled.

 

You have Home Assistant Container  setup.

 

A Matter-enabled device.

 

Setting Up Matter Server In Home Assistant OS( )

Step 1.Running the Matter Server using container image

 

 

Add Matter Integration

Add Matter Device 

 

step 1.your Matter Server is up and running.

you will have to start the Matter Server using Docker.

docker cli

mkdir data

docker run -d \

  --name matter-server \

  --restart=unless-stopped \

  --security-opt apparmor=unconfined \

  -v $(pwd)/data:/data \

  -v /run/dbus:/run/dbus:ro \

  --network=host \

  ghcr.io/home-assistant-libs/python-matter-server:stable

https://github.com/home-assistant-libs/python-matter-server

or

Running using Docker compose

For this, create a docker compose file with the following content.

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

start the Matter Server docker container

docker compose up -d

step 2.Now we need to connect it to Home Assistant.

Add  Matter Integration

you will have to add the IP address of the machine you are currently running the Matter Server.

ws://<your matter server machine IP address>:5580/ws

 

step 3.Adding A Matter-enabled Device to Home Assistant

Now to add the Matter device, you will have to use the Home Assistant App for Android or IOS

Once you have the app and you open it, go to the “Device & Services” settings page, click on “Add Integration” in the bottom right-hand corner and search for Matter.

 

Now click on “Add Matter Device”

 

 

 

Useful links

https://smarthomecircle.com/add-matter-devices-to-home-assistant

https://community.home-assistant.io/t/installing-matter-server-docker-image-on-a-raspberry-pi/637152/5