Unraid on UGREEN. Fans, LEDs, watchdog. Done right.

Fans. LEDs. Live case view. Sensors. One plugin. No kernel module.

Your UGREEN NAS is not a generic box. It deserves more than generic defaults.
This plugin is the bridge.

Release Unraid License: MIT

Live demo · Website · Install · Models · Help · All docs

_{The real plugin UI, rendered by CI. No mockups. Click through it in your browser.}

What it does

UGREEN builds its boxes with their own fan controllers, LED chips and watchdog. Unraid does not know them. The plugin does, and adds a settings page, a dashboard tile and a command line.

• Case view. Your box as it is: bays with drive temperatures and LED colours, rear ports, M.2, RAM, PCIe. Live demo.
• Fan curves in rpm. Presets or your own curve, measured rpm, full speed when too hot, BIOS values back if the plugin stops. More on fans →
• LEDs that say something. Colour, effects and brightness per LED: disk activity, errors, SMART, network speed, night mode. More on LEDs →
• Hardware watchdog, kept on. Leave it armed in the BIOS, the plugin feeds it, a frozen box reboots itself. More on the watchdog →
• Sensors, dashboard tile, MQTT. Sleeping disks stay asleep; status to Home Assistant, read-only. MQTT has no settings page yet: it is set in fan.cfg. More on MQTT →
• **7 languages**, a command line (`ugreen-nas-ctl`, `ugreen-nas-fan`). [More on the CLI →](docs/cli.md) · [Languages →](docs/translations.md) · [FAQ →](docs/faq.md)

Your model. Your status.

Runs on every x86 UGREEN NAS with Unraid 7.2+. The ARM-based models cannot run Unraid. Every status is dated and linked to its evidence.

2 verified, 8 community-tested, 9 expected. ● verified · ◔ community-tested · ○ expected.

• DH: ○ DH2600
• DX: ◔ DX4600 Pro, DX4700+
• DXP: ● DXP4800 GT, DXP6800 Pro · ◔ DXP480T Plus, DXP2800, DXP2800 GT, DXP4800, DXP4800 Plus / Pro, DXP8800 Plus · ○ DXP2800S, DXP4800S, DXP6800 / DXP6800 Plus, DXP6800 Ultra, DXP6800S, DXP8800 / DXP8800 Pro, DXP8800 Ultra
• iDX: ○ iDX6011 / iDX6012 / Pro

Per-capability status, versions, dates and evidence: docs/hardware.md, or the model page on the website.

Not verified or missing? The probe wizard maps unknown fan wiring in about a minute, and the Feedback page files the report. Report a model →

Install

1. Unraid: Plugins, Install Plugin
2. Paste this URL, hit Install:

https://raw.githubusercontent.com/ugreen-nas-control/ugreen-nas-control/main/plugin/ugreen-nas-control.plg

1. Open Settings, UGREEN NAS Control. It names the model it found.

Update: Plugins, Check for Updates. Stable releases come about every week. Next build (latest head of next, not for production): install https://ugreen-nas-control.github.io/ugreen-nas-control/next/ugreen-nas-control.plg; it keeps your settings. About, Switch to next does the same in one click, Back to stable returns. Channels and going back → · Unraid versions →

Help

Discussions · Unraid forum thread · GitHub issues · Which channel for what · FAQ

The project takes no money for now. It needs test reports and test hardware: Test hardware wanted.

More

All documents · Hardware matrix · Development · Contributing · Changelog

Credits

Built on the work of miskcoo, UGREEN's published driver sources and others: full list and licenses →

Maintained by j3n57h0m45 Jens Thomas and alexanderschubert Alexander Schubert.

321chills miskcoo datarepos76 Chiconydu69 ivolution DanielRuppen jsaltzman

Thanks to 321chills (DXP2800 GT: wiring research and fan control test), miskcoo (LED protocol and bay mapping (ugreen_leds_controller driver)), datarepos76 (DXP480T Plus: power LED reports (#145), DXP480T Plus report with diag (#271)), Chiconydu69 (DXP8800 Plus: fan wiring, header 4 confirmation, NVMe root ports, front-panel button tests, beeper test), ivolution (Spanish translation, DXP4800 Plus tests, DXP4800 Plus report), DanielRuppen (DXP2800 SUB2: ACPI and PCI data, lpss-probe runs, LED path confirmation) and jsaltzman (DXP6800 Pro bug reports, the cause of the failing update check) for testing, translating and research. And on the Unraid forum: fkiesler, gigios, NullNull67, cardsdoc, gonzlobo.

License

MIT. UGREEN and Unraid are trademarks of their owners; this project is not affiliated with either. Use at your own risk, see the disclaimer.