Problem with configuration and startup zigbee2mqtt. What I do wrong? | Home Assistant | Page 1

polar iron Jan 6, 2026, 10:49 AM

#

Hi, I'm having trouble getting zigbee2mqtt to work. I've tried various methods and tutorials, but nothing seems to help.

I'm using a "Sonoff Dongle Plus zigbee ZBDongle-E USB" connected to a Raspberry Pi 4 (8 GB).

I used to only use ZHA, and all Zigbee devices worked fine. Now, I have ZHA disabled. I installed Mosquitto broker and these are its Logs:

"[11:44:34] INFO: Successfully send discovery information to Home Assistant.
[11:44:35] INFO: Successfully send service information to the Supervisor.
2026-01-06 11:44:39: New connection from 172.30.32.1:47547 on port 1883.
2026-01-06 11:44:39: New client connected from 172.30.32.1:47547 as 2RbkwkUbPpG3EArGLunKNI (p2, c1, k60, u'homeassistant').
2026-01-06 11:45:15: New connection from 172.30.32.2:53388 on port 1883.
2026-01-06 11:45:15: Client <unknown> closed its connection."

I installed the Zigbee2MQTT add-on and these are its logs:

"[11:43:45] INFO: Preparing to start...
[11:43:45] INFO: Socat not enabled
[11:43:46] INFO: Starting Zigbee2MQTT...
Starting Zigbee2MQTT without watchdog.
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
READ THIS CAREFULLY
Refusing to start because configuration is not valid, found the following errors:

serial/adapter must be equal to one of the allowed values
If you don't know how to solve this, read https://www.zigbee2mqtt.io/guide/configuration
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
Failure page is available at http://0.0.0.0:8099/"

I have already entered various data in the Zigbee2MQTT configuration and it is always there Same result.

Can anyone help me?

Configuration | Zigbee2MQTT

Zigbee to MQTT bridge, get rid of your proprietary Zigbee bridges

cobalt patio Jan 6, 2026, 11:01 AM

#

To me that sounds like you didn't fill in the serial->adapter field

#

For you, that should be ember

#

Make sure you hit "Save" as well

polar iron Jan 6, 2026, 11:09 AM

#

I've already tried it and it's the same:

"[12:03:57] INFO: Preparing to start...
[12:03:57] INFO: Socat not enabled
[12:03:58] INFO: Starting Zigbee2MQTT...
Starting Zigbee2MQTT without watchdog.
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
READ THIS CAREFULLY
Refusing to start because configuration is not valid, found the following errors:

serial/adapter must be equal to one of the allowed values
If you don't know how to solve this, read https://www.zigbee2mqtt.io/guide/configuration
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
Failure page is available at http://0.0.0.0:8099/"

I also entered the port:

/dev/ttyUSB0
and this one
/dev/serial/by-id/usb-Itead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_V2_d25e4e7d73f3ef11aa1abb1b6d9880ab-if00-port0

It doesn't work either.

Configuration | Zigbee2MQTT

Zigbee to MQTT bridge, get rid of your proprietary Zigbee bridges

cobalt patio Jan 6, 2026, 11:10 AM

#

Port doesn't appear to be filled in on your screenshot

polar iron Jan 6, 2026, 11:13 AM

#

Yes, I've tried without the port entered. Now with the port entered and still the same.

#

Maybe I have MQTT configured incorrectly?

cobalt patio Jan 6, 2026, 11:15 AM

#

That error indicates an issue w/ your Z2M configuration

polar iron Jan 6, 2026, 11:16 AM

#

Ehhh... I don't know what to do

cobalt patio Jan 6, 2026, 11:20 AM

#

Can you paste the options configration YAML, by hitting dotsvertical -> Edit in YAML, selecting that and then pasting that between a code block (```)

#

If there's anything sensitive, you can edit that out

polar iron Jan 6, 2026, 11:24 AM

#

You mean this data?

"data_path: /config/zigbee2mqtt
socat:
enabled: false
master: pty,raw,echo=0,link=/tmp/ttyZ2M,mode=777
slave: tcp-listen:8485,keepalive,nodelay,reuseaddr,keepidle=1,keepintvl=1,keepcnt=5
options: "-d -d"
log: false
mqtt: {}
serial:
adapter: ember
port: /dev/ttyUSB0"

glass topaz Jan 6, 2026, 11:36 AM

#

use /dev/serial/by-id/usb-Itead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_V2_d25e4e7d73f3ef11aa1abb1b6d9880ab-if00-port0 in portsetting

polar iron Jan 6, 2026, 11:41 AM

#

I pasted it and still same result:

"data_path: /config/zigbee2mqtt
socat:
enabled: false
master: pty,raw,echo=0,link=/tmp/ttyZ2M,mode=777
slave: tcp-listen:8485,keepalive,nodelay,reuseaddr,keepidle=1,keepintvl=1,keepcnt=5
options: "-d -d"
log: false
mqtt: {}
serial:
adapter: ember
port: >-
/dev/serial/by-id/usb-Itead_Sonoff_Zigbee_3.0_USB_Dongle_Plus_V2_d25e4e7d73f3ef11aa1abb1b6d9880ab-if00-port0"

Logs:
"[12:37:42] INFO: Preparing to start...
[12:37:42] INFO: Socat not enabled
[12:37:43] INFO: Starting Zigbee2MQTT...
Starting Zigbee2MQTT without watchdog.
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
READ THIS CAREFULLY
Refusing to start because configuration is not valid, found the following errors:

serial/adapter must be equal to one of the allowed values
If you don't know how to solve this, read https://www.zigbee2mqtt.io/guide/configuration
!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
Failure page is available at http://0.0.0.0:8099/"

Configuration | Zigbee2MQTT

Zigbee to MQTT bridge, get rid of your proprietary Zigbee bridges

cobalt patio Jan 6, 2026, 11:41 AM

#

Something is definitely up w/ the Z2M add on configuration persistence... it's not just a you issue, I just confirmed it as well.

I'd say for now, if you can edit /config/zigbee2mqtt/configuration.yaml to contain the correct serial section, that should get things moved to the next step

#

Maybe because most people go through onboarding entirely and don't do what you're doing

polar iron Jan 6, 2026, 11:43 AM

#

I will try to go to the /config/zigbee2mqtt/configuration.yaml file and enter the port manually

cobalt patio Jan 6, 2026, 11:44 AM

#

and adapter

glass topaz Jan 6, 2026, 11:48 AM

#

perform a full reboot of haos after changing. not restart

polar iron Jan 6, 2026, 11:50 AM

#

Before and after. Is everything okay?

cobalt patio Jan 6, 2026, 11:51 AM

#

Do you want to force onboarding still? Looks like you may have already gone through it, but onboarding: true is still there

#

That might be toggled on in your settings

#

(Also a password is visible there, too)

glass topaz Jan 6, 2026, 11:52 AM

#

yep, remove pics 😉

cobalt patio Jan 6, 2026, 11:52 AM

#

I'd remove baudrate: entirely as well instead of just removing the value

polar iron Jan 6, 2026, 11:52 AM

#

😋

#

Will reset HA

cobalt patio Jan 6, 2026, 11:52 AM

#

But, also make sure any updates you make there make it to the add-on configuration panel too, since it will (at some point) rewrite that config

polar iron Jan 6, 2026, 11:59 AM

#

Now I see a different screen after clicking on Zigbee2MQTT.

Progress is happening 🙂

cobalt patio Jan 6, 2026, 12:00 PM

#

Yeah, you do still have onboarding still forced on the left. If you haven't gone through that before, you should, but that should be flipped back to false afterward otherwise it'll keep popping up

polar iron Jan 6, 2026, 12:02 PM

#

And now it's okey?

cobalt patio Jan 6, 2026, 12:03 PM

#

seems reasonable

polar iron Jan 6, 2026, 12:05 PM

#

Logs form zigbee2mqtt:

📎 message.txt

cobalt patio Jan 6, 2026, 12:05 PM

#

Credentials for mqtt look wrong

polar iron Jan 6, 2026, 12:07 PM

#

In Add-ons or Devives? 👀

cobalt patio Jan 6, 2026, 12:10 PM

#

You had a username/password set in your z2m config, right?

#

I assume that user/pass combo doesn't exist on Mosquitto

polar iron Jan 6, 2026, 12:21 PM

#

In the Zigbee2MQTT configuration, in the mqtt tab, I should have the username and password from this...? I must be doing something wrong.

cobalt patio Jan 6, 2026, 12:31 PM

#

You really shouldn't need to provide any of that if you're using the Mosquitto add-on on the same system

#

It should be using the addons user

polar iron Jan 6, 2026, 12:31 PM

#

Guys. It works!! Finally. Thank you so much for your help. I wouldn't have been able to do anything without manually entering Zigbee2MQTT in the configuration file, and you guys came up with the idea.

#Problem with configuration and startup zigbee2mqtt. What I do wrong?