# How to Manually Configure Zigbee2MQTT

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

<figure><img src="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2FDguQv3Nxhc3biCi9uaeJ%2Fimage.png?alt=media&#x26;token=a3f8b95e-f12e-419e-a56b-195b71e4ad09" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2Fd8BQIXxWEFRzur4lLMun%2Fimage.png?alt=media&#x26;token=8bdd24ef-5de5-4394-9fb7-ee5380a7c01f" 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="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2FFZM6q0PanerT4sW1V4H0%2Fimage.png?alt=media&#x26;token=dfdec6b1-e7ed-468b-a26a-25185566f6ac" 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="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2Fcu82zEtELLlK1t6krUDK%2Fimage.png?alt=media&#x26;token=f51fbd67-f9bd-46a1-a39b-a01289867aba" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2FmgY3Agezqm282Fgu9vk9%2Fimage.png?alt=media&#x26;token=51a3f294-bd10-4bde-9e8d-99f43fcfd80b" alt=""><figcaption></figcaption></figure>

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

<figure><img src="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2Fp9c13CQ8NuJRrIM2KgAW%2Fimage.png?alt=media&#x26;token=eec9825d-7c81-4ed7-9d2a-d03d370b6bdb" 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="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2FVHLUuQxbgKHHLOSjMgtl%2Fimage.png?alt=media&#x26;token=1891b64b-e811-4df9-a69d-5968bf6f9ee3" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2FLxg45sVFlvDIbzAnrUyd%2Fimage.png?alt=media&#x26;token=bacfdfc7-0f1f-4b0f-bcae-2f6420815f1f" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2FWdSAsJywaOVNNVKm9zUu%2Fimage.png?alt=media&#x26;token=b1f21b18-1d36-4d06-bde1-2a2ec31f1269" alt=""><figcaption></figcaption></figure>

<figure><img src="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2FaJWFFudY1ZHoSkwL7KDy%2Fimage.png?alt=media&#x26;token=aab452e4-e740-4e1c-a75d-590724e98ff3" 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="https://1561436000-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FpCtFemS511EXKjNnjKqg%2Fuploads%2FBR87UKpZUnuoyxshdyKY%2Fimage.png?alt=media&#x26;token=e1de43f3-5f60-4f1b-b032-cc5617ae4b13" alt=""><figcaption></figcaption></figure>
