How to check the zigbee network

rytecbe · November 19, 2025, 7:28pm

What is the best way to check if there are enough repeaters in the network to cover all the Zigbee2MQTT devices?

dandanache · November 19, 2025, 9:37pm

There’s really no such thing as “enough repeaters” in a Zigbee network .

On a more serious note: the key to a healthy Zigbee mesh is redundancy, not just coverage. You want multiple routing paths so that if one router drops out, your devices can still reach the coordinator without issues.

A quick way to check is to open the Zigbee map in Z2M. If it looks like a tangled web of connections between repeaters, that’s actually a good sign; the more overlapping lines, the more resilient your network is. In Zigbee, messy is healthy.

Shameless plug: I don’t really fancy the Z2M map so I built my own.

chairstacker · November 19, 2025, 10:46pm

And you also want to make sure that your repeaters stay online - having, e.g. smart bulbs that get powered off by a manual or a smart switch often do more harm than good for redundancy.

cambull · January 8, 2026, 11:47am

Nice work dandanashe . Does you visualisation tool work with ZHA too, or just Z2M?

dandanache · January 8, 2026, 12:13pm

Only with Z2M, sorry.

Edit: Starting with version 2.7.0, Zigbee Map also works with ZHA.

cambull · January 9, 2026, 5:01am

Thanks.

I have put in a feature request for something similar to yours, but on ZHA. Let’s see how that goes .

JJW.AU · January 9, 2026, 5:34am

I bulk extract my ZigBee router diagnostics logs from ZHA and then load them into Gemini AI to analyse. Helps identify problems. I also enabled debug logging on ZHA for a period of time and then ran the log file through Gemini to analyse. Found some really useful insights.

I’ve now removed spammy mains powered devices such as smart plugs with energy monitoring and air quality and presence sensors and that has helped stabilise my network. I’m gradually adding more dedicated routers throughout my house inside and outside.

I also monitor my LQI on my dedicated routers to ensure they don’t drop off.

FYI my coordinator (Sonoff Dongle Max) crashed at about 4:30am hence the drop off of LQI. A bit disappointed that I’ve had quite a few crashes requiring a physical disconnect and reconnect to fix. Must be buggy v1 firmware

rytecbe · January 12, 2026, 11:42am

Thanks a lot for your help, i tried do make the manual installation because I have the Z2mqtt in a seperate container but I get this message, what am I missing here?

jjross · January 13, 2026, 2:36am

Is it possible to write something like this for ZHA?

**Whoops, just saw your other reply, nothing to see here. Move along…

dandanache · February 3, 2026, 8:07pm

Added support for ZHA since version 2.7.0

jjross · February 3, 2026, 8:48pm

That’s great. I’ll have to come to the support thread because it’s blank when I use it and I’m seeing this in the logs:

Logger: frontend.js.modern.202601072
Source: components/system_log/init.py:331
First occurred: 1:47:37 PM (1 occurrence)
Last logged: 1:47:37 PM

Uncaught error from Edge 144.0.0.0 on Windows 10 TypeError: Cannot convert undefined or null to object /api/panel_custom/zigbee_map/zigbee-map-panel.js:203:17

Homerssistant · February 16, 2026, 8:32pm

It’s exactly the same here.
I have a blank page in “Zigbee Map” and “Zigbee Log” since a couple of days.
The log shows this message:

Logger: frontend.js.modern.202601286
Quelle: components/system_log/__init__.py:331
Erstmals aufgetreten: 15. Februar 2026 um 17:36:02 (15 Vorkommnisse)
Zuletzt protokolliert: 21:26:57

Uncaught error from Chrome 142.0.0.0 on Windows 10 TypeError: Cannot convert undefined or null to object /api/panel_custom/zigbee_map/zigbee-map-panel.js:195:17
Uncaught error from Chrome 142.0.0.0 on Windows 10 TypeError: Cannot convert undefined or null to object /api/panel_custom/zigbee_map/zigbee-log-panel.js:152:16
Uncaught error from Chrome 144.0.0.0 on Windows 10 TypeError: Cannot convert undefined or null to object /api/panel_custom/zigbee_map/zigbee-map-panel.js:195:17
Uncaught error from Chrome 144.0.0.0 on Windows 10 TypeError: Cannot convert undefined or null to object /api/panel_custom/zigbee_map/zigbee-log-panel.js:152:16

(BTW: I’m not running Win 10 but that’s just a side issue.)

HA, Z2M Add-on and Zigbee Map are installed in their latest versions.

I have no clue where to look at in order to search for a root cause.

The “Zigbee Map” add-on looked great when I started using it about two weeks ago.
Unfortunately, now that I started building up my Zigbee mesh, the add-on doesn’ show anything anymore.

Is there anything I can do to support finding the root cause?

mmstano · February 17, 2026, 6:24am

How do you have Zigbee Map installed/setup? Manually? HACS? GPM?

If you have it installed manually, there have been several updates and you’ll need to update the module code.

If you’ve installed with HACS, sometimes HACS doesn’t push updates (or maybe it does but the browser cache holds onto old appearances) and you won’t notice there’s an update until you restart/reboot HA. Make sure you’ve got the latest version installed and clear your browser cache.

GPM seems to be on the up-and-up when it comes to new version releases. Still, as mentioned and to really drill it in… verify you’re on the latest version then clear your browser cache.

If none of that helps bring back Zigbee Map to glory, report the issue on this thread. The developer is really good and may have additional pointers to debug and fix the issue.

Homerssistant · February 17, 2026, 4:04pm

Hi Matt,
Thanks for you reply.
I have installed Zigbee Map using HASC.
Since I have tried to clear the browser cache, used a different browser and also tried a browser on different PC with no sucess, I assume the problem is a server side one…
Maybe I should report the issue in the other thread. You are right.
I was following up here because I found another user facing the same issue.