Setup Home Assistant matter-server as a container with macvlan
This guide glosses over a lot of network details and how ipv4 and ipv6 works. It works in my case but mistakes or other differences could lose you access to your server or cause other problems on your network. I advise to only use it if you have knowledge of linux and network. Use at your own risk
Only try this if have problems setting up your HA matter-server with the error
CHIP Error 0x000000C1: Endpoint pool full with the official method (
Define a local ipv6 subnet(Matter needs(!) ipv6 connectivity with mDNS support):
Define IPv4 address for the matter-server(HA needs this address) and a second one for the bridge interface in your local network.
e.g. if your subnet is
- Bridge interface:
- Matter server:
Choose a name for the bridge interface e.g.
macvlan01. You also need the name of your servers network interface. e.g.
Make sure to replace all addresses and names in the following commands with your corresponding values.
Create the bridge:
ip link add macvlan01 link enp5s0 type macvlan mode bridge
Set the ip address of the bridge:
ip addr add 192.168.1.99/32 dev macvlan01
Enable the bridge:
ip link set macvlan01 up
Add route for the ipv4 adress of the container:
ip route add 192.168.1.100/32 dev macvlan01
Add route for the ipv6 subnet:
ip route add fd4b:8c60:5ef3:d321::/64 dev macvlan01
If you have done the steps you can create the docker-compose.yml(see the example below) and start the server. In HA you add the matter integration with url