4.4. Zigbee2MQTT

March 13, 2026

With this Add-on, it can better support the setup of Zigbee devices from different brands and categories to iSG.

1. Prerequisites:

1）Zigbee Upgrade

iSG users upgrade the Zigbee Dongle to the ZHA version,https://kb.linknlink.com/isg/settings/firmware-updates/zigbee-dongle-firmware
iSG MAX users upgrade Zigbee to the ZHA version.https://kb.linknlink.com/isg/settings/firmware-updates/built-in-zigbee-firmware，
Why I Can't Get Zigbee Firmware Update on iSG Display Max，https://kb.linknlink.com/isg/faq/others/why-i-cant-get-zigbee-firmware-update-on-isg-display-max
How to differentiate between iSG Display and iSG Display Max，https://kb.linknlink.com/isg/faq/others/how-to-differentiate-between-isg-display-and-isg-display-max

2）Remove the ZHA integration installed in Home Assistant in iSG.

3）Restart iSG

4）Go to iSG Add-on, find MQTT Broker add-on and enter the username and password you want for the MQTT service..

2. Install and configure Zigbee2MQTT

1）Install Zigbee2MQTT

2）Configure Zigbee2Mqtt

Note: After you enter the information in the configuration pop-up window, click Save. If the content you entered is not displayed, please click Enter again.

Original iSG

iSG MAX

3）Enable Service and Auto Start Service

4）Use PC web browser and enter iSG IP:8080

5) Configure Zigbee2MQTT in the web page

Make sure Zigbee2Mqtt is Not in Join Status
Enter Settings - Home Assistant integration
Choose Home Assistant (advanced)
Input Home Assistant Status topic: hass/status
Click Submit

3. Configure HA MQTT Integration

1）In HA settings - Devices & Services - Add integration, search MQTT and add to HA.

2）Click CONFIGURE MQTT

3）Click RE-CONFIGURE MQTT

4）Fill in the Broker information from iSG Mqtt Broker add-on into here

4. Add Zigbee devices in HA

After the MQTT Integration is configured, please come back to Zigbee2MQTT page. Click "Permit join (All)" and reset your Zigbee device. The Zigbee2MQTT service will automatically discover the device and let it join in.

Now, return to Home Assistant and navigate to Devices page, you will find the Zigbee device automatically shows up.

5. Add devices to iSG

Go to iSG - Devices - Add Device - Home Assistant, choose devices and add to iSG

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.