Control Zigbee2MQTT from your Android phone
Zigbee2MQTT has a web page for pairing and settings, but it isn't made for switching a light from the sofa. Here is how to put your Zigbee2MQTT devices on your phone with ZigDash, whichever way Zigbee2MQTT runs at your place.
First: where does Zigbee2MQTT run?
- Inside Home Assistant (the Zigbee2MQTT app, with the Mosquitto broker app): go through Home Assistant, below.
- On a hub of its own: an SMLIGHT SMHUB, a Raspberry Pi, Docker on a server. Go through your MQTT broker, below.
- ZHA, Home Assistant's built-in Zigbee: that isn't Zigbee2MQTT, and ZigDash can't show those devices.
Way 1: through Home Assistant
- Install ZigDash and tap Find my setup, then Sign in with Home Assistant.
- Give it your Home Assistant address. 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.
- Home Assistant's own login opens in your browser; ZigDash never sees your password. Your user needs to be an administrator.
That's it: your devices appear as tiles, and the connection works wherever your Home Assistant address works. More detail in the Home Assistant guide.
Way 2: through your MQTT broker
- Put your phone on your home Wi-Fi and tap Find my setup. ZigDash looks for the broker on your network.
- Not found? Type the hub's address, like
192.168.1.20, and tap Check this address. - If the broker asks for a login, use the MQTT user from Zigbee2MQTT's settings. On an SMLIGHT hub, the setup shows where to make one.
Hub-specific notes are in the setup guide; if you're choosing a hub, see Hubs we recommend.
Way 3: through the Zigbee2MQTT page
If you can open Zigbee2MQTT's own web page but don't have the broker's details, ZigDash can connect through that page. The dashboard works the same. Automations, alerts and History need the broker, so ZigDash asks for it when you turn those on.
Once it's connected
- The dashboard builds itself: a tile for every light, shutter, plug, switch, sensor and thermostat, in rooms you can rearrange.
- Without opening the app: home-screen widgets, Quick Settings tiles in the notification shade, and Android's device controls.
- Automations that run on the hub: ZigDash Engine puts your rules inside Zigbee2MQTT, so they keep working with your phone off. Three per home are free. Needs Zigbee2MQTT 2.4 or newer.
- Alerts and History: leaks, smoke and open doors reach every phone of the home; temperatures and power over days, recorded on the hub.
- A wall tablet: an old Android tablet makes a good wall display. How to set one up
Free, with an optional one-time Pro (History over days, unlimited automations, the wall tablet extras, remote control). No account, no ads. Open source.