UGREEN NAS
Tom-Bom-badil/home-assistant_ugreen-nas · vv2026.10.1
Home Assistant integration for UGreen's Network Attached Storage devices.
In Apple Home through HomeKit Bridge
What HomeKit Bridge makes of each kind of entity this integration creates, read from its source code. A device only gets the ones that apply to it.
| Entity | Shows up as | Note |
|---|---|---|
sensor | Sensor (temperature, humidity, air quality…) | |
button | Button (as a switch) | |
select | Mode picker (as switches) |
What people report
UGREEN NAS integration polls locally; recent UGOS firmware logins fail with error 9406, often caused by 2FA, which a merged PR now handles.
- Partly works1
- Not working1
| Device | In Home Assistant | In Apple Home | What they said | Source |
|---|---|---|---|---|
| UGREEN DXP4800 Plus | Partly works | Login error 9406 on UGOS 1.15.1.0127; owner says it works on same versionSaved copy… code=9406 msg=El cliente no es compatible con el firmware, ¡por favor actualice el cliente! ## Environment - Integration version: v2026.05.3 - NAS model: UGREEN DXP4800 Plus - UGOS firmware: 1.15.1.0127 - Home Assistant version: 2026.4.3 ## Steps to reproduce 1. Update UGOS firmware to 1.15.1.0127 2. Restart Home Assistant 3. Integration fails to login with code 9406 ## Log extract ERROR (MainThread) [custom_components.ugreen.api] [UGREEN] login failed code=9406 msg=El cliente no es compatible con el firmware, ¡por favor actualice el cliente! ERROR (MainThread) [custom_components.ugreen] … Excerpt saved from GitHub on 2026-10-23. | Discussion #221 · 2026-05 | |
| UGREEN DX4600 | Not working | Stopped displaying properly after an update; owner suggests reconfigureSaved copyWhich update? NAS Firmware or HA Integration? - restart both HA and NAS, - check on the NAS if the user you have specified is admin, - reconfigure the NAS once (HA Settings menu). /tom Excerpt saved from GitHub on 2026-10-23. | Discussion #243 · 2026-07 |
Gathered from GitHub issues, pull requests, discussions and docs, and from r/homeassistant. These are individual reports, so check the linked thread and the date before you buy.
How it connects
Local polling
Talks to the device on your network, asking it for updates every so often.
Found automatically over
- Bonjour (zeroconf)
Details
| Installs (analytics) | 1,462 (0.21%) |
|---|---|
| GitHub stars | 269 |
| Latest version | v2026.10.1 (2026-10-11) |
| Set up in the UI | Yes |
| Maintainers | @Tom-Bom-badil, @dobby5 |
| License | GPL-3.0 |
In ReReHome
Whatever HomeKit Bridge shares reaches Apple Home as normal HomeKit accessories behind your Home Assistant bridge, so ReReHome shows and controls them like any other.
Bridges get their own settings page listing the accessories behind them.
