Connecting to Home Assistant via Z2M App(formerly Add-on)


Preparation #


Step 1: Install Apps #


When connecting HA through the Zigbee2MQTT App(formerly Add-on), you need to install two Apps:

  1. Mosquitto broker (MQTT Broker)
  2. Zigbee2MQTT

Install MQTT Broker #

Install Zigbee2MQTT #

1. Add Repository

Go back to the App(formerly Add-on Store), click" ⋮ "→ "Repositories", fill in

and click "Add" → "Close" or click the "Add repository" button below, click "Add" → "Close"

2. Install Zigbee2MQTT

Step 2: Configure Zigbee2MQTT #


Open the Zigbee2MQTT App → Configuration page.
You need to configure the device's adapter type and serial port path under serial.

The following format:

adapter: Adapter Type
port: Dongle Serial Port Path
YAML


Example Configuration for Dongle-PP10:

adapter: zstack
port: /dev/ttyUSB0
YAML

⚠️ The serial port path may vary depending on the host system. On Linux, you can find the serial path by running:

ls -l /dev/serial/by-id
Zsh

Example output:

coolkit@coolkit-All-Series:~$ ls -l /dev/serial/by-id
total  0
lrwxrwxrwx 1 root root 13 3月 31 18:09 usb-Itead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_V2_76536147c914ef11950378b8bf9df066-if00-port0 -> ../../ttyUSB0
Zsh

The serial port path in this case is:

/dev/ttyUSB0
Zsh

After completing the configuration, start the Zigbee2MQTT App. Wait for about two minutes, then you can click to enter the Web UI Console to add and manage devices.

What are your feelings

Updated on November 2, 2026