ZigDash with Home Assistant
ZigDash shows the devices that Zigbee2MQTT runs. On Home Assistant that means the Mosquitto broker app and the Zigbee2MQTT app (Home Assistant called them add-ons until 2026). Your automations stay in Home Assistant and keep running.
1. Check the two apps
In Home Assistant, open Settings › Apps (Settings › Add-ons on older versions) and check that both are installed and started:
- Mosquitto broker: the MQTT broker.
- Zigbee2MQTT: with your devices paired. Its configuration should point at the Mosquitto broker (the default on Home Assistant).
2. Connect through Home Assistant (the easy way)
Your phone talks to Home Assistant, and Home Assistant talks to the broker. That works wherever you can open Home Assistant, your home Wi-Fi or your remote link included.
- In ZigDash, tap Find my setup. On the result, choose Home Assistant, then Connect through Home Assistant. (It's also under manual entry.)
- Give ZigDash the address you open Home Assistant with. Easiest: in the Home Assistant app, open Settings › Companion app, tap your server, then the share icon, and pick ZigDash; or copy it there and tap Paste in ZigDash. You can also type it:
192.168.1.20:8123,homeassistant.local, or a remote address likehttps://xyz.ui.nabu.casa. New installs of Home Assistant open on port 80, and ZigDash tries both. - Tap Sign in with Home Assistant. Home Assistant's own login page opens in your browser; ZigDash never sees your password. If that page refuses (Home Assistant without internet), paste a long-lived access token instead: in Home Assistant, your profile › Security › Create token.
It needs two things: your Home Assistant user must be an administrator (Home Assistant only lets administrators use its MQTT), and Home Assistant must have the MQTT integration set up (it is, when the Mosquitto broker app is installed the usual way). ZigDash tells you if either is missing.
ZigDash keeps the sign-in on your phone, in the same secure storage as passwords, and uses it only for MQTT. To end it, delete the home in ZigDash, or remove ZigDash under your profile › Security in Home Assistant.
3. Or connect to the broker directly
The older way: your phone connects to the Mosquitto broker app itself. It needs your phone on the same network as Home Assistant, and an MQTT login.
Make a user for ZigDash
The Mosquitto broker app accepts Home Assistant users. Most people make one just for MQTT:
- Settings › People › Users › Add user. (Turn on Advanced mode in your profile if you don't see Users.)
- Give it a name like
zigdashand a password. It doesn't need to be an administrator.
You can also use your own Home Assistant login, or a login set in the Mosquitto broker app's options.
Connect
- With your phone on your home Wi-Fi, open ZigDash and tap Find my setup. When it asks where Zigbee2MQTT runs, choose Home Assistant.
- If it doesn't find it, type the address you open Home Assistant with, for example
192.168.1.20:8123, and tap Check this address. ZigDash finds the broker on the same machine. - When it asks for a login, enter the user you made.
homeassistant.local doesn't work on every Android phone. Use the number address: Home Assistant shows it under Settings › System › Network. For this direct way, a remote link such as Nabu Casa or DuckDNS doesn't work; if that's all you have, connect through Home Assistant instead.The Mosquitto broker app checks each login with Home Assistant, which can take a few seconds on a Raspberry Pi. If ZigDash says the broker didn't answer the login, try again.
4. Optional: bring your names and rooms
In ZigDash, Settings › Import from Home Assistant reads the names and rooms you gave your devices in Home Assistant, and can make a dashboard for each room. It reads them once and keeps nothing else from Home Assistant.