Release notes: Beta v2026.03.1
Note: For those who experimented with the integration before and have more than one NAS adopted: please remove all NAS devices before proceeding. Single-NAS configurations should be converted automatically during the update process, but if you want to be on the safe side, remove that one as well.
- Go to HACS,
- filter for
ugreen, click the three-dot menu on the right, - choose
Update information, then click the menu again and chooseRedownload, - a window will appear that lets you choose any available GitHub release,
- pick the topmost item marked
Pre-release, - choose
Downloadand restart Home Assistant when asked to do so. Done.
You can revert back to the latest official release the same way (HACS will always replace the entire integration folder, so there will be no beta leftovers). Just choose the topmost non-prerelease item in the list.
Update 2026/03/24 (thanks to Discord user RoboJo101111 for the find):
After installing the beta, HACS will throw an update note. Don't install this 'update', as it will automatically roll back to the latest release version:
When adopting a NAS, there is a new mandatory field: Unique device name. It is prefilled with UGREEN NAS to make the new integration compatible with older versions. If you had installed an older version of the integration before, it is recommended to leave it at the default value (as you can continue using your existing dashboard, even without updating it). New users can pick any name that meets the requirements mentioned below the data field.
The device name has 2 purposes:
- It is used for grouping all device, sub-devices, and entities information in
Devices and Services > UGreen. - It is used as a prefix in the names of all NAS entities.
Example: If you call your deviceBasement NAS, all its entities will be prefixed withbasement_nas_. The former entitysensor.ugreen_nas_cpu_model(with the fixedugreen_nas_prefix the old versions of the integration were using) is from now on calledsensor.basement_nas_cpu_model. That makes addressing a particular entity on a particular device pretty easy.
Once a NAS is adopted, you should be able to filter for its entities in the Developer Tools (e.g. just filter for basement).
If you are a user of my Example dashboard, proceed to the configuration instructions below.
p.s. The prefix above is the reason why the default device name is UGREEN NAS - if you keep it, all entities will have the same names as before the update, and everything will work as before: the old sensor.ugreen_nas_cpu_model will keep its name in the new integration version as well.
This section only applies to users of the Example dashboard. Before you proceed, please make sure you go through both steps in the dashboard installation instructions again (both the template code and page code have been updated for Multi-NAS).
As you can see, a new dropdown lets you choose any configured NAS.
The default dashboard is made for my DXP4800+. This will of course not fit all configurations out there - so there are now some new configuration options available (before, you had to configure this by editing the page YAML directly). Just go to Devices and Services > UGreen, click the gear icon on the right of the NAS name, and you will be presented with the advanced settings:
- New options let you choose the maximum number of tiles to show in one row at the top right of the dashboard: Disks, Pools, Volumes (default: 5, 2, 2). If the number of tiles exceeds this value, a new line of tiles will be created automatically.
- Also, you can specify an individual picture to be displayed for this specific NAS (bottom left of the dashboard). Just copy the desired picture to
www/community/ugreenand specify the exact file name here.
Side note: I have designed the dashboard in a way that every element is a separate card. So it is easy to move, edit, delete or copy any card to suit your own ideas. [x]
📚📌✅✔️🗣️❤️💯🐳🎈📝🛠️👉👈📃🪪