logo elektroda
logo elektroda
X
logo elektroda

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

p.kaczmarek2 4521 2
ADVERTISEMENT
  • Zigbee2MQTT logo featuring a yellow hexagon with a bee icon and the text Zigbee2MQTT.
    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.

    Cool? Ranking DIY
    Helpful post? Buy me a coffee.
    About Author
    p.kaczmarek2
    Moderator Smart Home
    Offline 
    p.kaczmarek2 wrote 11883 posts with rating 9960, helped 569 times. Been with us since 2014 year.
  • ADVERTISEMENT
  • #2 21079663
    elezibi
    Level 21  
    With me it has always been

    Home Assistant update interface with a list of 9 available updates.

    Zigbee2MQTT update window in a system showing new software versions. .
  • #3 21079683
    p.kaczmarek2
    Moderator Smart Home
    They must have added this some time ago, because now I have it too:
    Software updates list with five items: Home Assistant Core, File editor, Samba share, Terminal & SSH, Zigbee2MQTT.
    Older versions you can't update this way, you have to do for them as in the article.
    Helpful post? Buy me a coffee.
ADVERTISEMENT