All apps · 0 apps
UGREEN LED Driver
Plugin from ich777
Overview
This package contains the UGREEN LED Driver which will allow you to get your LEDs to work on your UGREEN NAS (please note that not all models are supported).
The plugin is based on: https://github.com/miskcoo/ugreen_dx4600_leds_controller
Readme
View on GitHubUnraid UGREEN LED Driver Plugin
This is the repository for the Unraid UGREEN LED Driver plugin based on: https://github.com/miskcoo/ugreen_dx4600_leds_controller
Support Thread: https://forums.unraid.net/topic/92865-support-ich777-amd-vendor-reset-coraltpu-hpsahba/
What This Plugin Does
This Unraid plugin adds comprehensive LED control functionality to UGREEN NAS devices, transforming your NAS into a visual monitoring system. It provides:
- Disk Activity Monitoring: Individual hard drive activity indicators with LED flashing
- Network Status Monitoring: Real-time network connectivity and speed visualization
- System Health Monitoring: Disk health and availability status indicators
- Hardware Compatibility: Support for multiple UGREEN NAS models
Supported UGREEN Models
The driver supports these UGREEN NAS models:
- DXP6800 series (tested on DXP6800 Pro)
- DX4600 series (tested on DX4600 Pro)
- DX4700 series
- DXP2800 series
- DXP4800 series
- DXP8800 series (tested on DXP8800 Plus)
- DXP480T series (tested on DXP480T Plus) - uses static white LED only
LED Color Meanings
Disk LED Colors
| Color | RGB Values | Meaning |
|---|---|---|
| White | 255 255 255 |
Healthy disk - Normal operation (solid) |
| White | 255 255 255 |
Disk activity - Brief flash when I/O detected |
| Red | 255 0 0 |
Disk unavailable/offline - Disk has gone offline or is not accessible (solid) |
Network LED Colors
| Color | RGB Values | Meaning |
|---|---|---|
| Orange | 255 165 0 |
Normal network - Default state when speed is unknown (solid) |
| Green | 0 255 0 |
100 Mbps connection (solid) |
| Blue | 0 0 255 |
1 Gbps connection (solid) |
| Yellow | 255 255 0 |
2.5 Gbps connection (solid) |
| White | 255 255 255 |
10 Gbps connection (solid) |
| Red | 255 0 0 |
Gateway unreachable - Network connectivity issues (solid) |
| Any Color | Various | Network activity - Flashes on TX/RX activity |
Monitoring Features
Disk Monitoring
- Activity Detection: LEDs flash briefly (100ms on/off) when disk I/O activity is detected
- Health Monitoring: Continuously checks if disks are online every 5 seconds (configurable)
- Status Indicators: Solid white = healthy disk, solid red = disk offline/unavailable
- Slot Mapping: Maps physical disk slots to LED indicators using ATA, HCTL, or serial number mapping
- Empty Slot Handling: LEDs are turned off for disk slots that don't have drives installed
Network Monitoring
- Speed Detection: Automatically detects network interface speed and changes LED color accordingly (solid color)
- Activity Indicators: LED flashes on network transmit/receive activity (500ms interval)
- Gateway Connectivity: Pings the default gateway every 30 seconds (configurable) to verify connectivity
- Interface Detection: Automatically detects the primary network interface from Unraid configuration
Special Cases
- DXP480T Model: Uses a special static white LED configuration instead of dynamic monitoring
- Model-Specific Mapping: Different models may use different disk-to-LED mappings (e.g., DXP6800 has custom mapping)
Configuration Options
The plugin creates a settings.cfg file with these configurable parameters. The settings file is stored at: /boot/config/plugins/ugreenleds-driver/settings.cfg
| Parameter | Default | Description |
|---|---|---|
MAPPING_METHOD |
"ata" |
How to map disks to LEDs (ata, hctl, or serial) |
DISK_SERIAL |
"SN1 SN2 SN3 SN4" |
Serial numbers for disk mapping |
COLOR_DISK_HEALTH |
"255 255 255" |
Color for healthy disks (white) |
BRIGHTNESS_DISK_LEDS |
"255" |
LED brightness level |
COLOR_DISK_UNAVAIL |
"255 0 0" |
Color for unavailable disks (red) |
LED_REFRESH_INTERVAL |
"0.5" |
How often to check for disk activity (seconds) |
CHECK_DISK_ONLINE_INTERVAL |
"5" |
How often to check disk online status (seconds) |
CHECK_GATEWAY_CONNECTIVITY |
"true" |
Whether to monitor network connectivity |
COLOR_NETDEV_NORMAL |
"255 165 0" |
Color for normal network (orange) |
COLOR_NETDEV_LINK_100 |
"0 255 0" |
Color for 100 Mbps (green) |
COLOR_NETDEV_LINK_1000 |
"0 0 255" |
Color for 1 Gbps (blue) |
COLOR_NETDEV_LINK_2500 |
"255 255 0" |
Color for 2.5 Gbps (yellow) |
COLOR_NETDEV_LINK_10000 |
"255 255 255" |
Color for 10 Gbps (white) |
COLOR_NETDEV_GATEWAY_UNREACHABLE |
"255 0 0" |
Color for gateway issues (red) |
CHECK_NETDEV_INTERVAL |
"30" |
How often to check network status (seconds) |
Installation
- Install the plugin through the Unraid Community Applications or manually
- The plugin will automatically detect your UGREEN NAS model
- Configuration file will be created at
/boot/config/plugins/ugreenleds-driver/settings.cfg - LEDs will start working immediately after installation
Troubleshooting
- LEDs not working: Check if your model is supported and ensure the kernel module loaded correctly
- Wrong disk mapping: Adjust the
MAPPING_METHODin settings.cfg - Network LED issues: Verify network interface detection and gateway connectivity
- Performance issues: Adjust refresh intervals in the configuration file
Credits
Based on the excellent work by miskcoo for the original UGREEN LED controller implementation.
Install UGREEN LED Driver on Unraid in a few clicks.
Find UGREEN LED Driver in Community Apps on your Unraid server, review the template, and click Install. Unraid handles the Docker app or plugin setup from the published template.
Open the Apps tab on your Unraid server Search Community Apps for UGREEN LED Driver Review the template variables and paths Click Install
Requirements
UGREEN NAS
Categories
Download Statistics
3,334
Total Downloads
163
This Month
265
Avg / Month
Downloads by Month
Loading chart...
Related apps
Explore more like this
Explore allDetails
Repository
https://raw.githubusercontent.com/ich777/unraid-ugreenleds-driver/master/ugreenleds-driver.plgLast Updated2026-07-17
First Seen2024-06-20