ZigDash

Setting up ZigDash

ZigDash connects to the MQTT broker that your Zigbee2MQTT already uses. Most people are done in a minute.

What you need

No Zigbee2MQTT yet? Open ZigDash and try the demo home first.

The whole setup in 52 seconds · also on YouTube

1. Let ZigDash find it

  1. Connect your phone to your home Wi-Fi. Not a guest network, and turn mobile data off while you set up.
  2. Open ZigDash and tap Find my setup. While it looks, tell it where Zigbee2MQTT runs: Home Assistant, an SMLIGHT hub, a Raspberry Pi or Docker, or not sure.
  3. ZigDash looks for an MQTT broker on your network, then checks that Zigbee2MQTT is on it.
  4. Pick the devices you want and you have a dashboard.
If your phone isn't on Wi-Fi, ZigDash says so and gives you a button for the Wi-Fi settings. Once you join, it scans again by itself.

2. Nothing found? Connect by address

The scan can miss a hub behind a second router, on a mesh network, or one that answers slowly. Type its address instead:

  1. Find the hub's address: in your router's app, or the address you open Home Assistant or the hub's web page with. It looks like 192.168.1.20.
  2. Type it in ZigDash and tap Check this address. You can paste the link from your browser too.
Use the number, not a name. Names ending in .local don't work on every Android phone. Use the address that works at home, not a remote link such as Nabu Casa or DuckDNS.

In manual setup the usual settings are TCP, port 1883. Use 8883 only if your broker is set up for TLS. Port 8080 or 80 is the hub's web page, not MQTT.

3. The login

If the broker asks for a login, it wants the MQTT login, not the password of your hub's web page.

Zigbee2MQTT already logs in to this broker, so its web page shows the username under Settings › MQTT. Copying a password can add a space at the end; check for one.

Notes for your hub

Home Assistant

Needs the Mosquitto broker app and the Zigbee2MQTT app, both running. The easiest way is Connect through Home Assistant: sign in once, no broker address or MQTT user, and it works away from home too. Full steps in the Home Assistant guide.

Raspberry Pi, Linux or Docker

Mosquitto 2 only accepts connections from the machine it runs on until you tell it to listen on the network. Add this to mosquitto.conf and restart Mosquitto:

listener 1883
password_file /etc/mosquitto/passwd
allow_anonymous false

Create the user with mosquitto_passwd -c /etc/mosquitto/passwd zigdash (leave out -c if the file already exists).

SMLIGHT (SMHUB, SLZB)

Open the hub's web page, go to Settings › MQTT and turn on Allow External, so your phone can reach the broker. Check that Zigbee2MQTT shows as running.

Away from home

At home ZigDash talks to your hub directly. Away from home there are three ways: