Matter Home-Assistant
Hello, I'm trying to configure Home Assistant with Matter server. If I understand I have to put the Docker Matter on the host network. There must be an error in my dockercompose.json because it doesn't work.
{
"schemaVersion": 2,
"$schema": "https://schemas.runtipi.io/dynamic-compose.json",
"services": [
{
"name": "homeassistant",
"container_name": "homeassistant",
"image": "ghcr.io/home-assistant/home-assistant:2025.10.4",
"internalPort": 8123,
"isMain": true,
"volumes": [
{
"hostPath": "${APP_DATA_DIR}/data/config",
"containerPath": "/config"
},
{
"hostPath": "${APP_DATA_DIR}/data/localtime",
"containerPath": "/etc/localtime",
"read_only": true
},
{
"hostPath": "${APP_DATA_DIR}/data/dbus",
"containerPath": "/run/dbus",
"read_only": true
}
],
"restart": "unless-stopped",
"depends_on": ["matter-server"]
},
{
"name": "matter-server",
"container_name": "matter-server",
"image": "ghcr.io/home-assistant-libs/python-matter-server:stable",
"volumes": [
{
"hostPath": "${APP_DATA_DIR}/data/matter",
"containerPath": "/data"
}
],
"network_mode": "host",
"restart": "unless-stopped"
}
]
}
8 Replies
What doesn’t work exactly?
Your file don't fit the expected schema.
You should edit your file with something like VS Code, this should highlight the errors
Some instructions are incorrect.
You need to fix:
- read_only -> readOnly
- network_mode -> networkMode
You need to remove:
- restart (runtipi add it automatically)
- container_name (runtipi use his own naming convention)
Home Assistant asks for the homeAssistant server address. I tried everything I could and nothing works and I checked in Portainer it doesn't see anything on the Host network.
I used VScode and it passes the dockercompose test on https://runtipi.io/docs/reference/dynamic-compose
Dynamic Compose Reference
Homeserver management made easy
Homeassistant works very well it's just the connection to matter that doesn't want to be done
I will do this 👍
I actually think it's my network mode that's not good for the Matter server
Does it work with the official appstore Matter app ?
I honestly don't know much about Matter myself, I should take time to test a bit.
Seems to work fine with a good config, you just need to replace localhost with your address when asked.
Hi! It's okay I succeeded. I think network-mode was misplaced in my docker-compose file