# UGREEN LED Driver

UGREEN LED Driver is a command-line tool and kernel module that restores front-panel power, network, and hard-drive activity LED indicators on compatible UGREEN DX/DXP NAS devices running third-party operating systems. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/4097/ugreen-led-driver

## Description

UGREEN LED Driver is a command-line tool and kernel module that restores front-panel power, network, and hard-drive activity LED indicators on compatible UGREEN DX/DXP NAS devices running third-party operating systems by replicating the native UGOS (UGREEN operating system) control logic.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

69/100 (Good), based on 4 of 5 factors.
- Maintained: 86 (last commit 55 days ago)
- Popular: 56 (666 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)
- Security check: 95 (no serious findings, CI, tests)

## Links

- Unraid: https://ca.unraid.net/apps/ugreen-led-driver-0duq13w0fx3pmw?q=UGREEN%20LED%20Driver
- GitHub: https://github.com/miskcoo/ugreen_dx4600_leds_controller

## Common questions

### How can I check whether the LED control protocol is compatible on a UGREEN NAS?

Follow the preparation steps to check protocol compatibility and run ./ugreen_leds_cli all.

### What areas should I troubleshoot if the LED controller does not work?

Check hardware detection problems, module conflicts, LED control failures, disk mapping errors, and service startup issues.

### Why do only the power LEDs blink on DX models running a third-party OS?

Third-party operating systems lack the native LED driver, so on devices such as the DX 4600 Pro only the power indicator blinks while the other LEDs remain off.

### Where is experimental support for some newer UGREEN models provided?

Some experimental model support is available in the v0.4-beta release.

---
Source: Our Local Host (https://ourlocalhost.com/app/4097/ugreen-led-driver), the self-hosted and open-source app directory.
