Matter Server web UI page won't load even though add-on is working fine otherwise

tonyinseattle · August 17, 2025, 4:51pm

I have an issue where the Matter Server page won’t load in the app or in any browser. Rebooting HAOS momentarily fixes the issue (I was able to connect one time) and then it’s back to where it started about 2 minutes later (the next time I tried to connect). I can confirm my matter devices are connected and I review the Matter Server log. I’m running HA on a Beelink mini-PC. I have the latest software updates installed.

When I click Matter Server in the sidebar, it takes me to http://192.168.—.—:8123/core_matter_server/ingress, but the right side of the page is just blank. I get these messages in the Matter Server log:

2025-08-17 09:39:26.737 (MainThread) DEBUG [matter_server.server.client_handler] [139645551525424] Connected from 172.30.32.2

2025-08-17 09:39:26.762 (MainThread) DEBUG [matter_server.server.client_handler] [139645551525424] Disconnected

Any ideas?

wmaker · August 18, 2025, 9:53pm

You may have to explain what you mean by “sidebar”?

When you go to the MatterServer AddOn page (I assume you are using HAOS based install) there is a button “Open Web UI”…does that work?

tonyinseattle · August 22, 2025, 8:00pm

Hey there… I’m not sure I wasn’t notified about your comment. Here are the answers to your questions:

The sidebar is the left menu of the HA interface. In the add-on configuration, there’s an option to add the Matter Server to the sidebar, and I did. This link usually takes you to the web UI. However it does not work anymore.
If I navigate to the add-on and choose open Web UI, it still doesn’t work. Yes, I’m using an HAOS install.
I opened port 5580, and I was able to navigate to :5580 and it worked, but this is only a solution when I’m at home and does not work remotely. But it works, so this tells me that something is wrong in the Home Assistant configuration.

We had a power outage the other day and after everything came back online I still could not access the Matter Server web ui. So, contrary to what I put in the OP, a reboot doesn’t necessarily fix it.

Thanks for the help.

Tony

wmaker · August 22, 2025, 8:30pm

HAOS installs have a capability called “Ingress” which allows webservers on AddOns to use the HA Core webserver for access by the user. I don’t know much else, but for sure your Matter AddOn’s Ingress has gotten messed up somehow along the way which would explain why both the sidebar and the AddOn’s GUI (via :8123) are not working.

About the only recommendation I have would be to try to downgrade the Matter Server from a backup and see if that works, then upgrade it.

tonyinseattle · August 23, 2025, 3:11pm

I’m hesitant to mess with the matter server too much since I have approx 100 devices in there that run my smart home. Unless there’s a way to repair Ingress I might have to live with no access to the web ui until it fixes itself.

I’ve put this on GitHub so I’m hoping that it gets looked at by someone on the team.

Anyone out there know how to repair ingress issues?

francisp · August 23, 2025, 3:18pm

if you expose the web port, you can access the matter webserver via xx.xx.xx.xx:5580

tonyinseattle · August 23, 2025, 3:39pm

But only locally, right? I need a remote solution too.

francisp · August 23, 2025, 3:41pm

Only locally, unless you put it behind a NGINX reverse proxy.

tonyinseattle · August 24, 2025, 5:25pm

I opened the port again this morning and restarted the Matter Server, and yes, I can access the web UI locally using the direct link through the open port. But it does not – obviously – allow me to access the web UI through ingress or using Nabu Casa.

Does anyone know how to escalate this or report it as a bug? I added a post to Github. Does that automatically do it?

francisp · August 24, 2025, 5:26pm

Github should do it

wmaker · August 24, 2025, 5:49pm

Yes you have the correct Github Repo, and you have an HA developer looking at it.

tonyinseattle · August 24, 2025, 7:46pm

Excellent, thank you

tonyinseattle · October 18, 2025, 3:21pm

This issue is still alive for me and the github posting was marked as stale. Not sure what could be causing the issue or how to fix it. But it’s definitely a Home Assistant bug of some kind as I can’t connect to the web UI on any device (PC, ipad, iphone) or using any browser (even browser’s I’ve never used with HA before). Any ideas how I can get the web UI back via ingress? I can connect to it via the open Matter Server port, but that only works locally. Using Terminal, I can see that Ingress is active and I can get the URL with the token, but all I see is “Connecting…” and it doesn’t resolve.

Any help is apppreciated!

tonyinseattle · October 18, 2025, 5:37pm

I did updates and rebooted everything and was able to access the Matter Server web UI for about an hour. Then after that it stopped and I found these two errors in the Home Assistant Core logs:

Logger: homeassistant.components.hassio.handler
Source: components/hassio/handler.py:330
integration: Home Assistant Supervisor (documentation, issues)
First occurred: 09:13:10 (1 occurrence)
Last logged: 09:13:10

Client error on /ingress/validate_session request 401, message=‘Attempt to decode JSON with unexpected mimetype: text/plain; charset=utf-8’, url=‘http://172.30.32.2/ingress/validate_session’

Logger: homeassistant.components.hassio
Source: components/hassio/websocket_api.py:145
integration: Home Assistant Supervisor (documentation, issues)
First occurred: 09:13:10 (1 occurrence)
Last logged: 09:13:10

Failed to to call /ingress/validate_session -

Any ideas?