Python Matter Server docker dataset

ZkiiFreak · March 10, 2026, 7:24am

Hi there

Has finally got a somewhat stable Matter setup with HA, OTBR and Matter.
The Matter is Package python-matter-server · GitHub

I cannot seem to find documentation on the Python Matter Server which tells me how to persist the Dataset across reboots/restarts of the container. How do I add it to the Docker run or in some kind of config-file?

Hope someone can chip in
Thanks

micharambou · March 10, 2026, 3:47pm

Hi!

Check out the docs at

github.com/matter-js/python-matter-server

docs/docker.md

0f44085cd

# Running Matter Server in Docker

For testing/evaluation purposes or as a guideline towards other application developers that want to run the Matter Server, we do provide an [official Docker container image](https://github.com/matter-js/python-matter-server/pkgs/container/python-matter-server). Just make sure that the underlying operating system on which you intend to run the docker container matches the [requirements needed for Matter and Thread](os_requirements.md) so better not attempt to run it on a specific purpose operating system such as a NAS.

> [!NOTE] **Attention Home Assistant users:** The docker image is provided as-is and without official support (due to all the complex requirements to the underlying host/OS). Use it at your own risk if you know what you're doing.

We strongly recommend using Home Assistant OS along with the official Matter
Server add-on to use Matter with Home Assistant. The Matter integration
automatically installs the Matter Server as an add-on. Please refer to the
[Home Assistant documentation](https://www.home-assistant.io/integrations/matter/).

Home Assistant OS has been tested and tuned to be used with Matter and Thread,
which makes this combination the best tested and largely worry free
environment.

If you still prefer a self-managed container installation, you might experience
communication issues with Matter devices, especially Thread based devices.
This is mostly because the container installation uses host networking, and
relies on the networking managed by your operating system.

This file has been truncated. show original