ZigDash

Starting Home Assistant with Zigbee

You want Home Assistant, Zigbee lights and sensors, and your home on your phone. This page covers the hardware, and the steps from an empty Home Assistant to your devices in ZigDash.

ZHA or Zigbee2MQTT?

Home Assistant can run Zigbee in two ways, and you choose once, when you plug in the Zigbee adapter. Changing later means pairing every device again.

ZHAZigbee2MQTT
What it isHome Assistant's own Zigbee, built inA separate app, connected through MQTT
Setting upA few tapsTwo apps to install: Mosquitto and Zigbee2MQTT
DevicesManyA very long supported-device list, and more settings per device
Without Home AssistantNoYes: your Zigbee keeps its own web page
ZigDashDoesn't workWorks

Both are good. If you want ZigDash on your phone or a wall tablet, choose Zigbee2MQTT. Already on ZHA? See Moving from ZHA.

What to get

From an empty Home Assistant to ZigDash

These steps are for Home Assistant OS, where Settings shows Apps (Add-ons on older versions). Home Assistant Green and the Pi image are Home Assistant OS. In Docker, see Home Assistant in Docker.

  1. Set up Home Assistant and make your user.
  2. Plug in the Zigbee adapter on its extension cable. Home Assistant may find it and offer to set it up for ZHA or Thread. Choose Ignore: the adapter is for Zigbee2MQTT.
  3. In Settings › Apps, install and start Mosquitto broker. Home Assistant then offers the MQTT integration under Settings › Devices & services: accept it.
  4. Zigbee2MQTT isn't in the default app store. In the app store, open ⋮ › Repositories and add https://github.com/zigbee2mqtt/hassio-zigbee2mqtt, then install Zigbee2MQTT.
  5. In its Configuration tab, set the serial port and the adapter type from the adapter list, then start it and open its web page.
  6. Pair your devices: in Zigbee2MQTT's web page, turn on Permit join, then put each device in pairing mode (usually a long press, or switching a bulb on and off a few times). Mains-powered devices first, then battery ones.
  7. On your phone, install ZigDash, tap Find my setup, choose Home Assistant, and sign in with Home Assistant. The dashboard builds itself from your devices. More detail: ZigDash with Home Assistant.
ZigDash's sign-in needs a Home Assistant administrator, because Home Assistant only lets administrators use its MQTT. The user you made in step 1 is one.

Without Home Assistant

If you only want Zigbee devices on your phone, you don't need Home Assistant: an SMLIGHT SMHUB runs Zigbee2MQTT itself. See Hubs we recommend. You can add Home Assistant later; it connects to the same Zigbee2MQTT.