The Unraid control plugin for UGREEN NAS. Fans, LEDs, watchdog.
Your UGREEN is not a generic box. Quiet fans with a safe fallback, the hardware watchdog kept fed so a frozen box reboots itself, LEDs that say something, a live case view of every bay. One plugin, no kernel module. The box below is the real plugin: click it.
Free, MIT, open source. Unraid 7.2+. LEDs, fans and case view verified on DXP4800 GT and DXP6800 Pro.
Which UGREEN do you have? Pick yours, the page switches to it.
- Quiet fans that fail safe.Multi-point curves. Too hot: every fan to 100 percent. Plugin stops: BIOS values return.
- A frozen box reboots itself.Keep the BIOS watchdog on. The plugin feeds it (supported models).
- No kernel module.Nothing to rebuild after an Unraid update. A weekly check watches the newest Unraid kernel for what the plugin relies on.
- See your box.Case view, bay LEDs and a dashboard tile, drawn for your model.
Fan curves. Measured, not guessed.
Quiet, Standard, Performance, Full speed or your own curve.
One click measures real rpm at fixed speeds. Too hot? Every fan goes to 100 percent. Plugin stops? BIOS values take over. Seven more models get a probe wizard that maps their fan chips. Bring yours.
Verified on DXP4800 GT, DXP6800 Pro. Community-tested on 4 models. All models
Techie details
- Inputs per fan: CPU, hottest disk or disk average, NVMe, GPU, HBA, NIC, your own script, or the hottest of several. Sleeping disks stay asleep.
- Per fan: deadband, kick-start, minimum speed, ramps, quiet hours, a floor or boost during the mover or a parity check.
- A hot CPU or disk, or a CPU temperature it cannot read, sends every fan to 100 percent, never capped or scheduled. A stopped fan raises a notification. BIOS values are written back when the plugin stops.
- Take over your FanCtrl Plus 2 settings: import them, with a preview, or export your own.
- Unknown fan wiring (DXP2800, DXP4800, DXP4800 Plus and Pro, DXP8800 Plus): a probe of about a minute finds the fans; control stays off until you confirm.
See why every fan did what it did.
The last hour or the last 24 hours, per fan.
Speed, rpm and temperature per fan, with a coloured lane for the input that drove the speed. Quiet hours, mover and parity boosts and emergencies are marked.
Verified on DXP4800 GT, DXP6800 Pro. Community-tested on 4 models. All models
Techie details
- One hour in 10 second steps, 24 hours in 60 second averages. Per fan: speed, rpm, the temperature of its input; CPU and hottest drive for reference.
- Kept in the daemon's RAM (about 100 KB). Nothing is written to the flash drive; a restart starts it empty.
Keep the watchdog on. A frozen box reboots itself.
If the BIOS watchdog is on, the plugin feeds it while the system is alive. If the system freezes, the feed stops and the hardware resets the box. DXP4800 GT, iDX6011 Pro, DXP2800, DXP4800, DXP4800 Plus and Pro, DXP6800 Pro, DXP8800 Plus.
Listed in the matrix: DXP2800, DXP4800, DXP4800 GT, DXP4800 Plus / Pro, DXP6800 Pro, DXP8800 Plus and iDX6011 Pro. See the matrix
Techie details
- The plugin never arms it. It feeds a timer that is already running, and stopping or uninstalling never triggers a reset.
- Feeds: DXP4800 GT and iDX6011 Pro (embedded controller) and the IT8613E models, where it writes only after seeing the timer count down. No feed on the DXP2800 GT, the plain iDX6011 and iDX6012.
- That a feed reloads the counter is not yet confirmed on hardware; the card says so if a feed did not take.
- Something arms itUGREEN's driver, another tool or the firmware. The plugin only reads whether it is on.
- The plugin feeds itA small service rewrites the timeout on a steady beat while the system is alive. On the IT8613E it waits until the timer was seen counting down.
- A frozen box reboots itselfThe beat stops, the timer runs out, the hardware resets the box.
See inside your box.
UGREEN built the case. We built the dashboard for it.
Every bay shows drive temperature and LED colour. The rear shows ports and LAN link speed. On the DXP4800 GT and DXP6800 Pro you see inside too.
Verified on DXP4800 GT, DXP6800 Pro. Partly confirmed on DXP480T Plus. Community-tested on DXP2800, DXP4800 Plus / Pro, DXP8800 Plus. All models
Techie details
- Front, rear and inside view (M.2, RAM, system, PCIe where the model has them) on every model. The DXP4800 GT and DXP6800 Pro are drawn after a real device (verified); the others after UGREEN manuals, product photos and renders, or after a sister model (expected).
- The demo above is the plugin's own interface on sample data, not a mockup.
LEDs that say something.
Off until you switch them on.
Colour, effect and brightness, per LED. Bays show activity and errors, the network LED shows link speed.
Verified on DXP4800 GT, DXP6800 Pro. Partly confirmed on DXP480T Plus. Community-tested on 6 models. All models
Techie details
- Per bay: disk activity, errors, SMART warnings, standby and parity states. The network LED follows link speed, traffic or gateway. Identify a bay from the page.
- Night mode dims every LED. Settings from UGREEN LED Control import in one click.
- No kernel module: the ich777 LED driver and the single-model LED projects need one built per Unraid release.
- Off until you switch them on. If a rival LED tool owns the same chip, the plugin steps aside and says so.
Where you already look.
The Unraid dashboard, and Home Assistant.
A tile with fans, temperatures, SSDs and live LEDs. A Sensors page for CPU, board, iGPU, NVMe and disks.
Verified on DXP4800 GT, DXP6800 Pro. Community-tested on DXP480T Plus, DXP2800, DXP8800 Plus. All models
Techie details
- Sensors for CPU, board, iGPU, NVMe and disks, each marked with the fan it steers.
- An optional MQTT publisher feeds displays and Home Assistant. Read only, off until you set a broker in fan.cfg.
- The interface comes in 7 languages.
- About switches between stable and next (test builds) through the Unraid install dialog; settings stay.
Others fit any box. This one fits yours.
FanCtrl Plus 2 and Dynamix Auto Fan drive any generic fan; neither knows UGREEN's fan chips. This plugin does, adds multi-point curves, rpm calibration, LEDs and a case view for your model, and needs no kernel driver.
Only facts you can check. Rows marked Ahead are where another tool leads.
| What | This plugin | Other tools |
|---|---|---|
| Fan chips without an extra kernel driver | Yes (verified on DXP4800 GT, DXP6800 Pro) | No for FanCtrl Plus 2, Dynamix Auto Fan and the UGREEN fan driver (it87). Yes for the iDX6011 plugin |
| Case view drawn per model | Yes | No in FanCtrl Plus 2, Dynamix Auto Fan and the UGREEN fan driver. Yes in the iDX6011 plugin |
| Languages | 7 | None of the others documents translations |
| LEDs without a kernel module built per Unraid release | Yes | No for the ich777 LED driver and the single-model LED projects |
| Multi-point fan curves | Yes | No in FanCtrl Plus 2 and Dynamix Auto Fan; partial in two others |
| Fan calibration (rpm per duty) | Yes | No |
| Fan inputs: GPU, HBA, NIC, custom script | Yes | Same in FanCtrl Plus 2; no in the others |
| Fan speed history graph | Yes, with the input that drove each speed | Yes in FanCtrl Plus 2 (on par). Partial in the iDX6011 plugin, no in the other fan tools |
| Touch LCD (iDX6011 Pro) | No (declined) | Ahead: iDX6011 plugin |
Sources and method
Compared 2026-10-29 from public READMEs: FanCtrl Plus 2, Dynamix Auto Fan, UGREEN-DXP-FAN-NAS-Driver, ich777 it87 and ugreenleds drivers, EllipticSet and flybrys LED drivers, the iDX6011 plugin by noodlemctwoodle. Sources: competition.md. Two programs writing the same fan or LED chip give no stable result: the plugin checks for them and stops writing fan registers while a rival runs. It never edits or removes the other tool.
Every model, every claim, on the record.
Every cell is dated and links to its evidence. Verified: a maintainer ran it. Community-tested: users confirmed it. Expected: the code covers it, nobody has confirmed it yet. Not green? Report it, or run the probe wizard.
2 verified, 8 community-tested, 9 expected.
- Verified
- Community-tested
- Partly confirmed
- Expected
- Not offered
| Model | LEDs | Fan control | Case view | Sensors | Front panel | Watchdog | Overall |
|---|---|---|---|---|---|---|---|
| DXP4800 GT | VerifiedNov 2026 | VerifiedNov 2026 | VerifiedNov 2026 | VerifiedNov 2026 | Expected | Expected | Verified |
| DXP6800 Pro | VerifiedOct 2026 | VerifiedOct 2026 | VerifiedOct 2026 | VerifiedOct 2026 | Expected | Expected | Verified |
| DX4600 Pro | Community-testedmiskcoo | Not offered | Expected | Expected | Expected | Not offered | Community-tested |
| DX4700+ | Community-testedusers | Not offered | Expected | Expected | Expected | Not offered | Community-tested |
| DXP480T Plus | Partly confirmedusers | Not offered | Partly confirmedNov 2026 | Community-testedNov 2026 | Partly confirmedNov 2026 | Not offered | Community-tested |
| DXP2800 | Community-testedusers, DanielRuppen | Community-testedDanielRuppen | Community-testedDanielRuppen | Community-testedDanielRuppen | Expected | Expected | Community-tested |
| DXP2800 GT | Expected | Community-tested321chills (issue 95) | Expected | Expected | Expected | Not offered | Community-tested |
| DXP4800 | Community-testedusers | Expected | Expected | Expected | Expected | Expected | Community-tested |
| DXP4800 Plus / Pro | Community-testedNov 2026 | Community-testedNov 2026 | Community-testedNov 2026 | Expected | Partly confirmedNov 2026 | Expected | Community-tested |
| DXP8800 Plus | Community-testedmiskcoo and users | Community-testedNov 2026 | Community-testedNov 2026 | Community-testedNov 2026 | Community-testedNov 2026 | Expected | Community-tested |
| DH2600 | Not offered | Not offered | Expected | Expected | Expected | Not offered | Expected |
| DXP2800S | Expected | Not offered | Expected | Expected | Expected | Not offered | Expected |
| DXP4800S | Expected | Not offered | Expected | Expected | Expected | Not offered | Expected |
| DXP6800 / DXP6800 Plus | Expected | Expected | Expected | Expected | Expected | Not offered | Expected |
| DXP6800 Ultra | Expected | Not offered | Expected | Expected | Not offered | Not offered | Expected |
| DXP6800S | Expected | Not offered | Expected | Expected | Expected | Not offered | Expected |
| DXP8800 / DXP8800 Pro | Expected | Expected | Expected | Expected | Expected | Not offered | Expected |
| DXP8800 Ultra | Expected | Not offered | Expected | Expected | Not offered | Not offered | Expected |
| iDX6011 / iDX6012 / Pro | Expected | Expected | Expected | Expected | Expected | Expected | Expected |
Install in 60 seconds.
Unraid 7.2 or newer. Runs on every UGREEN NAS that runs Unraid: the x86 DX, DXP and iDX series. (The ARM-based DH models can't run Unraid.)
In Unraid, open Plugins, Install Plugin and paste this URL:
https://raw.githubusercontent.com/ugreen-nas-control/ugreen-nas-control/main/plugin/ugreen-nas-control.plgPaste the URL
Plugins, Install Plugin, paste, Install.
Check your model
Open Settings, UGREEN NAS Control. It names the model it found.
Switch it on
Pick a fan mode. Turn the LEDs on. The case view and the dashboard tile fill with live data.
The demo runs in your browser on sample data.
Help the project.
The project takes no money for now. It needs test reports and test hardware.
- Test on your model: in the plugin open Feedback, answer, collect the data, and send the prefilled report.
- Lend or donate a test device (DXP2800 GT, DXP480T Plus, DXP8800 Plus, iDX6011 Pro, DXP2800 V1.2 board).
Credits.
Maintained by Jens Thomas and Alexander Schubert. Everyone below tested on their own box, sent data or helped otherwise.
- 321chillsDXP2800 GT: wiring research and fan control test
- miskcooLED protocol and bay mapping (ugreen_leds_controller driver)
- datarepos76DXP480T Plus: power LED reports (#145), DXP480T Plus report with diag (#271)
- Chiconydu69DXP8800 Plus: fan wiring, header 4 confirmation, NVMe root ports, front-panel button tests, beeper test
- ivolutionSpanish translation, DXP4800 Plus tests, DXP4800 Plus report
- DanielRuppenDXP2800 SUB2: ACPI and PCI data, lpss-probe runs, LED path confirmation
- jsaltzmanDXP6800 Pro bug reports, the cause of the failing update check
On the Unraid forum: fkiesler, gigios, NullNull67, cardsdoc, gonzlobo.
Want the detail?
Every feature above opens up for techies. Below: the smaller controls and where the hardware facts come from.
Front panel, power and new models.
Smaller controls from UGREEN's driver sources. None is confirmed on hardware yet.
- Front-panel buttons. Shows power and reset presses. Where users confirmed the buttons, an opt-in switch shuts Unraid down cleanly when the power button is held.
- Beeper test. Sounds the beeper where UGREEN names a beeper path.
- Power on after AC loss. On, stay off or last state. Written only when you choose.
- New models. DXP6800 and Plus, DXP6800S, DXP8800 and Pro, DXP2800S. Expected to work; nobody has run them.
- Rival tools. FanCtrl Plus, Dynamix Auto Fan, it87 and LED plugins and UGREEN kernel modules are detected. The plugin steps aside and never removes them.
Built on UGREEN's published driver sources.
UGREEN publishes its GPL kernel drivers. The plugin takes chip IDs, register addresses and frame formats from them and cites file and line. No UGREEN code is copied; the plugin is MIT. Nobody has checked that the published sources match the firmware UGREEN ships. Not endorsed or certified by UGREEN.
- Fans. Registers from UGREEN's IT5571 and IT8613E drivers. Header 4 of the IT8613E follows UGREEN's control register 0x1e, untested on hardware. Hardware status stays in the matrix.
- DXP2800 GT. Fan control stays off until you run a one-minute probe and confirm. Wiring from UGREEN's driver; fan control confirmed on hardware by a community tester, LEDs not yet.
- DXP2800 SUB2. The LED controller sits behind an Intel I2C controller. The LED path is opt-in and untested; a read-only check (lpss-probe) shows whether it fits your board.
- LEDs. Protocol from miskcoo's ugreen_leds_controller, which matches UGREEN's LED driver.
Credits. miskcoo, the LED protocol and bay mapping; UGREEN, the published driver sources; Geoff Davis, requested the sources from UGREEN under the GPL and reviewed the release.
UGREEN is a trademark of its owner. This project is not affiliated with UGREEN.