2FA has arrived, cache-disk bug fixed, more languages added

Changes in beta4

👉 Bug fixes

• only poll backup entities if a backup job exists (disks did wake up from sleep) (thanks for reporting to @sPioT)

👉 Added

• Add Bulgarian language (thanks for the PR to @LZ2ISI)

---

Changes in beta3

👉 Improvements

• skip disabled entities when creating polling groups on startup
• exclude endpoints that have returned a 404 HTTP error from active polling until next restart

Tip

Some people have complained about the huge number of entities the integration creates. From now on, you can just go to Settings > Devices and Services > Entities and disable all the entities that you think you don't need (use filter for more convenience, e.g. filter for your NAS name in HA, then enable check boxes in front of entities, select any you want, then use menu top-right to disable). On next restart, disabled entities will not be added to the update coordinator. This should also persist future updates.

Many thanks to @stefanodeg for reporting and suggesting these improvements! :)

---

Changes in beta2

👉 Bug fixes

• removed S.M.A.R.T. entities introduced in v2026.08, as they are preventing disk sleep (please delete obsolete SMART entities that become unavailable after this)
• improve API error logging even when the returned error is empty

Many thanks to @CharlesBronson72, @c0zm0 and @EscuelaMahatmaGandhi for testing and bug reporting - appreciate your help! :)

---

Changes in beta 1

tl;dr

• thanks to @naaraxi, who did the entire work, authenticator-based 2FA has arrived.
• fixed a bug in cache disk numbering (thanks for reporting @rmnp30).
• renovated the options flow when editing the NAS.
• stabilized entity ID's / make the failure-proof against those ongoing HA Core changes.
• added further languages for setup & options flow: ja (jp), ko, zh-Hans (cn), zh-Hant (cn), nl, pt, sv, da, nb (no), fi.

Full story

👉 Added

• optional two-factor authentication support using authenticator app codes.
• trusted-device registration for UGOS accounts with 2FA enabled.
• a separate Advanced settings step to the integration options flow.
• new languages for setup & options flow: ja (jp), ko, zh-Hans (cn), zh-Hant (cn), nl, pt, sv, da, nb (no), fi.

👉 Changed

• unified normal login and 2FA enrollment to use the same internal authentication mechanism.
• moved polling intervals and example-dashboard settings out of the main options page.
• updated all included translations for the revised options flow.

👉 Fixed

• stabilized entity IDs for the Fan Mode and Power Mode selects.
• fixed example-dashboard compatibility with newly created mode-select entities.
• fixed cache-pool and cache-disk key parsing.
• fixed incorrect assignment of cache disks to the wrong pool or cache device.
• fixed incorrect cache-device names, metadata, and device hierarchy caused by the parsing error.

👉 Notes

• two-factor authentication currently supports authenticator app codes only, Email-based 2FA codes are not supported.

Stand-alone disks, backup control, S.M.A.R.T. entities

Important

This update contains changes that affect the example dashboard. If you are a example dashboard user, please go through the installation procedure again and replace your existing code.

👉 List of major changes

• Added stand-alone disk support
• Added backup task monitoring and control
• Extended disk and volume monitoring, added S.M.A.R.T. entities
• Improved storage discovery and disk mapping
• Improved handling of storage summary sensors
• Removed fast-changing summary attributes to significant reduce disk space usage of the recorder database
• Added direct UGOS web link to Home Assistant device page
• Renamed some entities for consistent naming (please update your dashboards and delete obsolete entities)
• Updated Wiki pages (including more usage examples, e.g. the YAML of a dedicated backup control card)
• Lots of internal improvements

A detailed list of changes can be found on the change log.

👉 Credits

Special thanks for ideas, feature requests and testing go out to: @WyriHaximus (#239), @mattbue (#223 and #241) and @LainX84 (#227).

Bugfix release after API changes in UGOS (July 2026 firmware)

Included in this update:

• Fix disk, volume and LAN read / write speed sensors after recent UGOS API changes.
• Make disk index / disk numbering more robust and independent from UGOS API changes.
• Improve LAN link speed and DNS Server displaying on the example dashboard.

Note: No example dashboard changes are required for this update.

---

Upcoming changes in next feature release (work in progress - not included here): ¹

• Detect and add stand-alone disks which are not assigned to any pool (#227).
• Add entities and functions for backup monitoring (#223).
• Add further attributes to summary entities.

¹ Feel free to create a new discussion in case other important features should still be missing.

Fix the detection of LAN ports and the prefixes of some LAN entities

• Fixed two problems in the detection of LAN ports (see #219: Issues on single-LAN models and with ports operated in non-bridged mode).
• Fixed some LAN entity names to make them all appear the same way (LANx -> LAN x).

Due to the renaming, it is likely that you will have old / abandoned LAN entities after this update. Just delete them all (Settings -> Devices and Services -> Entities, filter for 'unavailable' und your NAS name, then select all and bulk-delete them).

New dashboard controls and entity statistics [updated]

-- this update to v2026.05.1 only contains the forgotten update to the manifest version number for HACS --

Original v2026.05.1 changes:

❗ Breaking changes

Some entity IDs were renamed for consistency and easier addressing:

• sensor.<nas>_fans_system_mode → sensor.<nas>_fan_mode
• button.<nas>_power_high_performance → button.<nas>_power_mode_high_performance
• button.<nas>_power_balanced → button.<nas>_power_mode_balanced
• button.<nas>_power_energy_saving → button.<nas>_power_mode_energy_saving
• button.<nas>_shutdown → button.<nas>_power_action_shutdown
• button.<nas>_wake_up → button.<nas>_power_action_wake_up
• button.<nas>_reboot → button.<nas>_power_action_reboot

If you see red cards in the entity view, just delete the old / orphaned entities from Settings > Devices & services > Entities.

If you use custom dashboards or automations, please update these entity IDs manually. The pre-made dashboard on the Wiki has already been updated accordingly.

👉 Changes for end users

• Added new buttons and dropdowns for setting power modes (see discussion #218)
• Added statistics support for numeric entities (see discussion #216)
• Added more dropdowns and buttons to the example dashboard
• Major Wiki revision, including more detailed dashboard tweaking instructions

👉 Internal changes

• Prepared the example dashboard for the next version of custom:button-card (see here); manually copying the template will no longer be necessary
• Added _raw values to summary entities
• Various minor optimizations

---

Special thanks for feature requests go to: @FrancescoMasi @JochenGr

New dashboard controls and entity statistics

❗ Breaking changes

Some entity IDs were renamed for consistency and easier addressing:

• sensor.<nas>_fans_system_mode → sensor.<nas>_fan_mode
• button.<nas>_power_high_performance → button.<nas>_power_mode_high_performance
• button.<nas>_power_balanced → button.<nas>_power_mode_balanced
• button.<nas>_power_energy_saving → button.<nas>_power_mode_energy_saving
• button.<nas>_shutdown → button.<nas>_power_action_shutdown
• button.<nas>_wake_up → button.<nas>_power_action_wake_up
• button.<nas>_reboot → button.<nas>_power_action_reboot

If you see red cards in the entity view, just delete the old / orphaned entities from Settings > Devices & services > Entities.

If you use custom dashboards or automations, please update these entity IDs manually. The pre-made dashboard on the Wiki has already been updated accordingly.

👉 Changes for end users

• Added new buttons and dropdowns for setting power modes (see discussion #218)
• Added statistics support for numeric entities (see discussion #216)
• Added more dropdowns and buttons to the example dashboard
• Major Wiki revision, including more detailed dashboard tweaking instructions

👉 Internal changes

• Prepared the example dashboard for the next version of custom:button-card (see here); manually copying the template will no longer be necessary
• Added _raw values to summary entities
• Various minor optimizations

---

Special thanks for feature requests go to: @FrancescoMasi @JochenGr

Multi-NAS has arrived + Bugfixes

Important

This update contains BREAKING CHANGES:

• All users: You may need to delete and re-adopt your NAS once in Devices and Services > Ugreen. All data will be kept, and all entities will automatically be re-created as long as you keep the default NAS unique name as ugreen_nas. Please make sure you use the 'Add' button offered by autodiscovery instead of manually adding the NAS.
• Pre-made dashboard users: Please run again through the Wiki page and replace your existing code with the new one to get all the new features.

👉 Changes: For end users

• The integration can now handle multiple UGreen NASes simultaneously (any models).
• The pre-made dashboard has been adjusted accordingly. It now also serves default pics for all NAS models in www/community/ugreen.
• Config flow has been amended to control Multi-NAS settings and individual display options for each NAS on the pre-made dashboard.
• Dashboard sort criteria for tiles and disks now working properly (both had wrong order in specific configs).
• Cache general info and cache disk entities / tiles have been reworked.
• Fixed an issue where the NAS would not wake up when pressing the Wake On LAN button.

👉 Changes: For fellow developers (internal changes)

• Add local brand icons and logos.
• Add further local languages for config flow (fr, es, it).
• Update and amend local translations.
• Add necessary consts for Multi-NAS and Dashboard.
• Create select.py and text.py for Multi-NAS Dashboard features.
• Implement changeable entity_prefix for Multi-NAS.
• Remove obsolete const_device_name.
• Add default picture files for Lovelace frontend.
• Implement automatic copying of picture files to /local/community/ugreen (=/config/www/community/ugreen).
• Further harden autodiscovery against double detection.
• Implement 'forgotten' cache summary entity.
• Move old www/pictures repo path to .deprecated.
• Bump version to v2026.03.1.

Many thanks to everyone who has been involved bringing forward this release, particularly to @mieldehabanero, @Chrissica06, Discord user RoboJo101111 and Facebook user Alfred Chin!!!

Bugfix: Fix log errors on HA startup

👉 For end users

• Fixed Detected blocking call errors on HA startup.
  v2026.01.1 introduced some new SSL/https: options. Removed those options again, because HA was throwing errors in some specific network configurations. Thank's @diegocjorge for reporting!

Bug fixes, child devices are back, WOL, handling offline mode (and more)

👉 For end users

• Fixed a Single pool dashboard issue
  The first fix in v2025.11 made the pool entities of single-pool configurations re-appear. However, there was still a bug displaying it on the 'Example dashboard'. Fixed (example dashboard remains the same, no update needed).
• Fixed missing devices in Settings > Devices and Entities > UGreen
  The rework of the device_info.py in v2025.12.1 made the sub-devices (e.g. pools, disks, volumes) disappear. All entites were put to the NAS main device itself. Fixed.
• Handle disconnections, and automatically re-connect
  It has been repeatedly reported that situations are not covered where the NAS goes offline for a while, or is shut down over night. Fixed - a few errors might still be written to the logs upon disconnect, but latest after 15s all API-calls should stop (and be restarted again after re-connect).
• Implemented WOL button
  Power on the NAS while sitting on your couch. Implemented a 'Wake up' button in Settings > Devices and Entities > UGreen that will power-up a shutdown NAS. The button can also be used in own automations, or on the dashboard (similar to the already-existing 'Shutdown' and 'Restart' buttons). ! Note that this funktion requires the 'Wake on Lan (WOL)` HA integration in addition. !
• Improved SSL handling
  Improved the general SSL handling with further options.

Thanks for bug reporting to: @morbiddk @wendefeuer @giovanniong98 @btexnic

👉 For fellow developers (internal changes)

• Renamed deprecated folder to .deprecated for better sorting
• Moved repository.json to .deprecated as it is not needed
• Moved dashboard pics into HACS/community folder (aka /config/www/community/ugreen)
• Re-phrased readme.md
• Bumped version to v2026.01.1

Improved discovery, cache entities, fan profile switching

👉 For end users

• Improved device detection / auto-discovery.
• Added cache disks and general cache entities.
• Added switching of cooling profiles (UGOS fan modes: quiet / default / full power).
• Added changing of polling intervals in the config flow (NAS device settings).
• Adjusted setup / config translations to match above changes.
• Adjusted 'Example Dashboard Page' to match above changes.
• Added a Fine-tuning your dashboard section on the Wiki.

👉 For fellow developers (internal changes)

• Lots of minor internal changes, but nothing serious. Please check change logs in the latest PR.