How to Manually Configure Zigbee2MQTT

1、Open the Add-on Manager and update to the latest scripts package.

2、Without inserting the dongle yet, open Serial Port Viewer. You should see an existing device listed (e.g., device1). Note: This add-on does not need to be installed. Every time you switch away to another add-on and come back, it will automatically re-scan serial ports.

3、Now insert your dongle, switch to another add-on, then come back to Serial Port Viewer again. You will now see an additional device in the list. This new device is your dongle’s serial port. In the example screenshot, the dongle appears as /dev/ttyUSB0.

4、Enable Zigbee2MQTT in the add-on list.

5、Open the Zigbee2MQTT initialization page in your browser: http://{ip}:8080

6、Complete the configuration.

Key points to note:

• Fill in the detected serial port, for example: /dev/ttyUSB0.

• Select the correct Adapter Driver for your dongle.For example，my dongle is zstask；

• MQTT configuration:

  • Change localhost to 127.0.0.1

  • Username: admin

  • Password: admin

• Enable all available checkboxes on this page.

7、If everything is configured correctly, Zigbee2MQTT will start successfully. Click “Permit Join” to begin scanning and adding devices.