# 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>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://kb.linknlink.com/isg/using-isg/add-ons/isg-required-add-ons/zigbee2mqtt/how-to-manually-configure-zigbee2mqtt.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.