Zigbee2MQTT Update 2.0.0 USB Adapter Error Fix

Zigbee2MQTT had a huge update to 2.0.0 and it added an adapter criteria setting to the config section. I cover it in my written guide to Zigbee2MQTT and on this video supplement. It's a quick fix that might catch you off guard if you didn't read the release notes!

Zigbee2MQTT Update 2.0.0 USB Adapter Error Fix

Zigbee2MQTT had a huge update to 2.0.0 and it added an adapter criteria setting to the config section. I cover it in my written guide to Zigbee2MQTT and on this video supplement. It's a quick fix that might catch you off guard if you didn't read the release notes!

The specific error that Zigbee2MQTT gave me was "USB adapter discovery error (No valid USB adapter found)" after auto-updating to Zigbee2MQTT 2.0.0 Guide on my website:

2.0.0 Breaking Change:

You now need to specify the adapter in the Z2M settings under Configuration -> Serial . Previously, you didn't need to.

For my Sonoff ZB Dongle Folks use : "zstack"

For anyone using the HomeAssistant SkyConnect use: "ember"

Just add the following to the serial section of your Zigbee2MQTT Serial Settings under the Configuration Tab.

adapter: zstack

How to Install Zigbee2MQTT on Home Assistant: Step-by-Step Guide
My 6th video on this channel was about how to install Zigbee2MQTT on HomeAssistant and I released in August of 2023. Just this week (1/7/25) there was an update to Zigbee2MQTT 2.0.0 that contained a breaking change. I wanted to update my write-up but noticed I never made one! Better late than never.

Github Discussion:

https://github.com/Koenkk/zigbee2mqtt/discussions/24364

https://github.com/Koenkk/zigbee2mqtt.io/blob/master/docs/guide/configuration/adapter-settings.md

Video link:

Privacy Policy
Terms and Conditions