> For the complete documentation index, see [llms.txt](https://kb.linknlink.com/isg/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://kb.linknlink.com/isg/using-isg/add-ons/isg-required-add-ons/zigbee2mqtt/how-to-manually-configure-zigbee2mqtt.md).

# How to Manually Configure Zigbee2MQTT

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

<figure><img src="/files/v2CYInysyT0M7SOo9JrX" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/ciNMWYh5EmX94kM3GEPn" alt=""><figcaption></figcaption></figure>

**2、Without inserting the dongle yet**, open **Serial Port Viewer**.\
You should see an existing device listed (e.g., *device1*).\
\&#xNAN;*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.*

<figure><img src="/files/4cnQA8oICZIg9AZnhljl" alt=""><figcaption></figcaption></figure>

**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**.

<figure><img src="/files/b69cMNApCItBnaZNzEwz" alt=""><figcaption></figcaption></figure>

**4、Enable Zigbee2MQTT** in the add-on list.

<figure><img src="/files/P63f3kg139BH2jI74kMu" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/fg3UaUSHIRoRg818w45c" alt=""><figcaption></figcaption></figure>

**6、Complete the configuration.**&#x20;

**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.

<figure><img src="/files/kZNDLjJVUiyARdLNlmmG" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/96jYrJHE6hDS5l1urbdn" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/8DQHc5Tpo6HiH3oFb7ou" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/PsRdyPdMbq6gvqJy7EnO" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/jNdXilmLMSBb7imuUtAU" alt=""><figcaption></figcaption></figure>