How to update Zigbee2MQTT Home Assistant to latest version? "unsupported device" solution

p.kaczmarek2 12 May 2024 11:46 2 5793 Cool? (+1)

📢 Listen (AI):

TL;DR

Updating Zigbee2MQTT in Home Assistant to fix an “unsupported device” problem for a Zigbee device like ZBMINIL2.
The fix requires backing up the Zigbee2MQTT YAML, uninstalling the add-on, removing and re-adding the hassio-zigbee2mqtt repository, then reinstalling and restoring the config.
The outdated add-on was version 1.18.1-1, while the device page showed official support in a newer Zigbee2MQTT release.
Home Assistant’s normal update flow did not update Zigbee2MQTT, and a simple uninstall/reinstall still left the same version.

Generated by the language model.

Here I will show you how you can simply update Zigbee2MQTT addon in your Home Assistant. Suprisingly enough, there is no automatic update for Zigbee2MQTT, or at least it does not show up for me. That's why the update has to be done manually.
I have been recently trying to add a new Zigbee device to HA and realized that my HA shows it as "unsupported", even while it's marked as "supported" on official site:

Screenshot showing a list of Zigbee devices in the Zigbee2MQTT panel.

The error message:


Received message from unsupported device with Zigbee model [model] and manufacturer name

Means that your version of plugin does not support it, but you can clearly check online if the newer one has added support:
https://www.zigbee2mqtt.io/devices/ZBMINIL2.html

Screenshot of Zigbee2MQTT panel showing an unsupported device.

In my case I had old version, barely 1.18.1-1:

Zigbee2MQTT add-on management panel in Home Assistant.

At first I went to the usual "updates" menu, hoping that I can do update automatically:

List of available updates for Home Assistant.

I've applied all updates, but Zigbee2MQTT still stayed old.
Home Assistant itself got easily updated to latest version:

Screenshot of Home Assistant Operating System update

The next thing I tried was first copying my configuration yaml from Zigbee2MQTT, and then uninstalling it (just to install it later). To copy configuration, select YAML here:

Screenshot of Zigbee2MQTT configuration in Home Assistant with YAML editing

Yaml code can be just copied to a text file to make a backup.
Then I tried uninstalling Zigbee2MQTT and just reinstalling it, but it wasn't enough - I got the same version.
To update, you need to remove the Add-on repository from addon repositories here:

Screenshot of the add-on repositories management panel in Home Assistant.

Then readd it again:


https://github.com/zigbee2mqtt/hassio-zigbee2mqtt

and then, finally, install zigbee2mqtt from the list:

View of the Home Assistant panel with the Add-on Store open, highlighting Zigbee2MQTT.

Then, finally, I got the new version of the plugin:

Zigbee2MQTT add-on interface in Home Assistant.

Summary
There is no ready update function for Zigbee2MQTT. In order to update it, you need to:
1. first backup your configuration as yaml
2. then uninstall the plugin
3. then remove the repository from addon store (at least I had to do that, maybe due to the cache, I am not sure)
4. then re-add the repository to addon store
5. then fresh install zigbee2mqtt
6. then, finally, restore your config from yaml
The steps above worked for me and now I can use even newer Zigbee devices with my HA. Let me know if they are working for you, I will try to help if there is a problem.

About Author

p.kaczmarek2 wrote 14406 posts with rating 12342 , helped 650 times. Been with us since 2014 year.

Comments

Add a comment

elezibi 12 May 2024 18:48

With me it has always been https://obrazki.elektroda.pl/7965449600_1715532393_bigthumb.jpg https://obrazki.elektroda.pl/2388967200_1715532410_bigthumb.jpg . [Read more]

p.kaczmarek2 12 May 2024 19:03

They must have added this some time ago, because now I have it too: https://obrazki.elektroda.pl/2620040300_1715533377_bigthumb.jpg Older versions you can't update this way, you have to do for... [Read more]

FAQ

TL;DR: Home Assistant users with Zigbee2MQTT can fix an “unsupported device” issue in 6 steps when no add-on update appears. “Older versions you can't update this way,” so back up YAML, remove the add-on, refresh the repository, reinstall, and restore config to get newer device support. [#21079683]

Why it matters: A fully updated Zigbee2MQTT add-on can turn a newly paired but unsupported Zigbee device into a usable Home Assistant device without changing Home Assistant itself.

Method	When it works	Main action	Result in thread
Built-in Update button	Newer add-on versions	Click update in add-on view	Present later, not originally available
Full manual reinstall	Older versions with no usable update path	Backup YAML, remove add-on, remove and re-add repository, reinstall	Replaced old 1.18.1-1 with a newer version

Key insight: If Zigbee2MQTT stays old after normal Home Assistant updates, the problem may be the add-on repository state, not Home Assistant. Refreshing the repository can expose the newer add-on version. [#21079174]

Quick Facts

The thread shows an old Zigbee2MQTT add-on version of 1.18.1-1, and that version lacked support for a newly added Zigbee device even though the device was listed on the official compatibility page. [#21079174]
The manual recovery path uses 6 distinct actions: back up YAML, uninstall the add-on, remove the repository, add it again, reinstall Zigbee2MQTT, and restore the YAML configuration. [#21079174]
A newer Home Assistant core version alone did not update the Zigbee2MQTT add-on in this case; Home Assistant updated successfully while Zigbee2MQTT stayed old. [#21079174]
The repository URL shown for reinstalling the add-on is https://github.com/zigbee2mqtt/hassio-zigbee2mqtt, and re-adding that source made the newer add-on appear. [#21079174]
The follow-up confirms 2 update paths now exist: a normal add-on Update button on newer releases and a manual reinstall path for older releases that cannot update that way. [#21079683]

1. How do I update the Zigbee2MQTT add-on in Home Assistant when no update shows up in the usual Updates menu?

Use the manual reinstall path. 1. Copy your Zigbee2MQTT YAML as a backup. 2. Uninstall the add-on, then remove the Zigbee2MQTT repository from the add-on store. 3. Add the repository again, reinstall Zigbee2MQTT, and paste back your YAML. This solved the issue when the normal Updates menu showed nothing and the installed version stayed at 1.18.1-1. [#21079174]

2. Why does Home Assistant show "Received message from unsupported device" in Zigbee2MQTT even though the device is listed as supported on the official Zigbee2MQTT site?

It usually means your installed Zigbee2MQTT version is too old for that device. In the thread, Home Assistant reported an unsupported device, but the device appeared as supported on the Zigbee2MQTT site. After moving off version 1.18.1-1 and reinstalling a newer add-on build, the author could use newer Zigbee devices. [#21079174]

3. What steps should I follow to back up and restore my Zigbee2MQTT configuration YAML before reinstalling the add-on?

Back up the YAML before you uninstall anything. Open the Zigbee2MQTT add-on, switch to the YAML view, copy the full configuration to a text file, then reinstall the add-on and restore that same YAML afterward. The thread lists backup first and restore last in a 6-step process to avoid losing settings. [#21079174]

4. Where can I find the Zigbee2MQTT YAML configuration in Home Assistant so I can copy it to a text file as a backup?

You can find it inside the Zigbee2MQTT add-on configuration screen by selecting the YAML view. The thread explicitly says to choose “YAML” there and copy the code into a text file. That backup lets you reinstall the add-on without rebuilding your configuration from scratch. [#21079174]

5. What is Zigbee2MQTT in Home Assistant, and how does it affect support for new Zigbee devices?

“Zigbee2MQTT” is a Home Assistant add-on that connects Zigbee devices through MQTT, with device support tied to the add-on’s own version rather than Home Assistant’s core version. If the add-on is old, a newly paired device can show as unsupported even when a newer Zigbee2MQTT release supports it. [#21079174]

6. What is an add-on repository in Home Assistant, and why would removing and re-adding the Zigbee2MQTT repository force a newer version to appear?

“Add-on repository” is a Home Assistant source entry that supplies add-on packages, version metadata, and installable releases to the add-on store, so changing that source can refresh what versions Home Assistant offers. In the thread, uninstalling alone kept the old release, but removing and re-adding the repository exposed the newer Zigbee2MQTT version. [#21079174]

7. Which Zigbee2MQTT repository URL should I add in Home Assistant to reinstall the latest add-on version?

Add the repository URL https://github.com/zigbee2mqtt/hassio-zigbee2mqtt. The thread shows that exact address in the manual recovery steps, and re-adding it let the newer Zigbee2MQTT add-on appear in the list for installation. [#21079174]

8. Why did uninstalling and reinstalling Zigbee2MQTT give the same old version until the repository was removed and added again?

Because Home Assistant kept offering the same repository state. The thread says a simple uninstall and reinstall still returned the old version, while removing and re-adding the repository changed the result. The author suggests this may have been caused by cache or stale repository data. [#21079174]

9. How can I check whether my Zigbee device model, such as Sonoff ZBMINIL2, is supported by my current Zigbee2MQTT version?

Check the device on the official Zigbee2MQTT device page, then compare that with the version installed in your Home Assistant add-on. In the thread, the example device was Sonoff ZBMINIL2, and support existed online while the local add-on still showed the device as unsupported because the installed version was old. [#21079174]

10. What is the difference between updating Zigbee2MQTT from the built-in add-on update button and doing a full uninstall plus repository refresh?

The built-in button is the normal path on newer releases, while the full reinstall is the fallback for older releases. A follow-up post shows an Update button available later, but also states, “Older versions you can't update this way.” Use the repository-refresh method when the button is missing or ineffective. [#21079683]

11. When should I use the manual Zigbee2MQTT reinstall method instead of the normal Home Assistant add-on update option?

Use the manual method when the Updates menu shows nothing, the add-on stays on an old release, or a newly paired device reports as unsupported. In the thread, Home Assistant itself updated successfully, but Zigbee2MQTT remained at 1.18.1-1 until the repository was removed and added again. [#21079174]

12. How do older Zigbee2MQTT add-on versions in Home Assistant behave compared with newer versions that show an Update button?

Older versions may not update through the normal button path at all, while newer versions can show a direct Update button in the add-on page. The follow-up confirms that the button appeared later, but older versions still required the manual article method instead of a one-click update. [#21079683]

13. What should I do if Home Assistant updates successfully but the Zigbee2MQTT add-on stays on an old version like 1.18.1-1?

Treat Zigbee2MQTT as a separate update problem. If Home Assistant updates but Zigbee2MQTT stays at 1.18.1-1, back up the YAML, uninstall the add-on, remove the Zigbee2MQTT repository, add it again, reinstall, and restore the configuration. That exact sequence moved the thread author off the old add-on release. [#21079174]

14. Which problems can happen after reinstalling Zigbee2MQTT in Home Assistant, and how do I avoid losing my settings or device configuration?

The main risk is losing your Zigbee2MQTT settings if you reinstall without saving the YAML first. The thread avoids that failure by copying the entire YAML configuration to a text file before uninstalling, then restoring it after the fresh install. Do the backup first, because reinstalling alone does not preserve your custom configuration steps automatically. [#21079174]

15. How can I troubleshoot a newly paired Zigbee device in Home Assistant when Zigbee2MQTT reports it as unsupported after pairing?

Start by verifying whether the device is supported in a newer Zigbee2MQTT release, then check your installed add-on version. If your version is old, update or manually reinstall Zigbee2MQTT and try again. In the thread, that approach fixed support for newer devices after the unsupported-device message appeared during pairing. [#21079174]

Generated by the language model.