Getting started

Requirement

In order to use Zigbee2MQTT, we need the following hardware:

  1. LilyGo Zigbee2MQTT

  2. A server that can run MQTT broker and Home Assistant (e.g. Raspberry Pi)

  3. One or more Zigbee devices that will be paired with Zigbee2MQTT.

Set up and start Zigbee2MQTT

Connect to MQTT server

See zigbee2mqtt.

Connect the device

Search for supported devices for your device and follow the instructions to pair.

Once you see something similar to the following in the log, your device is paired and you can start to control it using the front end and MQTT messages.

I (276254) Zigbee2MQTT: Successfully interviewed '0x00158d000774d938', device has successfully been paired

Home Assistant

Note

Home Assistant integrates MQTT, please refer to Home Assistant

After Home Assistant integrates MQTT, the device information will be reported to Home Assistant

_images/check-device.png

Follow the steps below to add devices to the homepage

_images/edit-dashboard.png _images/add-card.png _images/select-device.png _images/add-to-homepage.png

The addition is successful, you can see the changes in the measurement data in real time

_images/added.png