Home Assistant Matter not installing

I am having issues getting matter to install on my home assistant instance. My system is running Fedora 43 and is using the docker home asssistant container. My current version of home assistant is: 2025.11.1. It shows up as a device to install and is discovered on my network, but when clicked all it says is failed to connect. Are there any ways i can fix this? Matter would be such a cool thing to have to my home assistant instance! I would appreciate any help anyone can provide!

I wasn’t aware home assistant worked in containers, but I always just run a VM.

I believe matter runs on IPv6 but part of discovery is not, so you may need to check that IPv6 is working correctly on your network.

1 Like

I have checked my router and IPv6 addressing is enabled, here are the settings i currently have on my asus router:
Connection type native.
DHCP-PD: Enabled.
LAN Prefix length 64.
Auto configuration setting: Stateless.
IPV6 DNS connection: Automatic.
router advertisement Enabled.
Is there anything i am missing here?

1 Like

Assuming you don’t have those devices on a separate vlan I think that means IPv6 should be working. Idk what else to suggest. I just turned on the matter server in HA and it just worked after I turned IPv6 on.

1 Like

Did you take a look at the home assistant logs to see what it is actually complaining about?

1 Like


These are the only 2 errors that show up in the logs even after i tried to install it a couple of times again to produce fresh logs.

This is the generic and sparse of information error i get when i attempt to install it.
Matter error

1 Like

How did you install matter? Official docs:

Supported installation types

It is recommended to run the Matter add-on on Home Assistant OS. This is currently the only supported option. Other installation types are without support and at your own risk.

If you run Home Assistant in a container, you can run a Docker image of the Matter server. The requirements and instructions for your host setup are described on that GitHub page.

Did you set matter up on it’s own docker image?

I have the server running in a docker container on my PC since i use large llms in my home automations/assistants. So i have to run the matter server as a separate program?

Basically if you aren’t running Home Assistant OS - then that would have worked. Perhaps run Proxmox and then setup a HAOS, but then you can run a windows VM as a primary GPU so you still get the same ‘experience’ you have now but then also get the ability to run LXC containers as well - just a thought, but yes in your case right now it needs it’s own docker container setup.

1 Like

Thank you so much! I have setup a docker container on the same server my home assistant system is on. Once i have some matter devices I will update my status here.

Glad I could help - also just another gotcha I’ve seen is most devices are 2.4ghz only for wifi but if you use a phone to add thats on a 5ghz wifi it wont work, just keep that in mind when adding new things. (Phone needs to be on 2.4ghz when adding)

1 Like