Asustor Platform Drivers
Linux kernel driver plugin for Unraid that adds LED and button hardware support to ASUSTOR NAS systems.
Platform availability
Available on 1 of 10 platforms
- Unraid
- TrueNAS (not listed)
- Umbrel (not listed)
- ZimaOS (not listed)
- Proxmox (not listed)
- Helm (not listed)
- Mac (not listed)
- Windows (not listed)
- Linux (not listed)
- Any server (not listed)
Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.
58/100 Fair
- Maintained
- 72last commit 7 days ago
- Popular
- 41110 GitHub stars
- Easy to install
- 251 install platform, install notes
- Light to run
- No data
- Security check
- 85no serious findings, CI
Based on 4 of 5 factors.
Availability: platform listings confirmed today
- GitHub stars
- 110
- Open issues
- 16
- Last commit
- 2026-11-14
- Latest release
- v0.4.0
- License
- GPL-3.0
- Activity
- rising
Checked today - source: GitHub (mafredri/asustor-platform-driver)
Resources & Compatibility
Requirements not published yet.
First-install notes
- Reboot Required After Installation A system reboot is required after installing the plugin for the kernel driver to take effect. source
- Dependencies Mainline Linux kernel modules are required; some may need manual compilation if not included by your distribution. source
- Warning: Use at Your Own Risk This driver changes GPIO inputs/outputs to enable LEDs and buttons. Doing so without understanding the effects can be dangerous and lead to instability, corrupted data, or a broken system. Use at your own risk. source
- Hardware Safety This driver controls ASUSTOR LEDs and buttons through IT87 and CPU GPIO pins. Changing GPIO inputs/outputs without knowing their effects can cause instability, data corruption, or a broken system, so install only on supported ASUSTOR models. Mainline Linux kernel dependencies must be present or compiled yourself if your distribution omits them. source
- Build Missing Kernel Modules The driver relies on mainline Linux kernel modules for LED and button (GPIO) handling, and some are only needed on specific ASUSTOR models. If the module your board requires is not already included in your Unraid kernel, you may need to compile it yourself before the extra hardware support will appear. source
Fetched 29 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
Do I need to reboot after installing the Unraid plugin?
Yes, a system reboot is required after installing the plugin for the kernel driver to take effect.
How can I check whether my ASUSTOR device is supported?
Run `sudo dmidecode -s system-manufacturer` and `sudo dmidecode -s system-product-name`, then compare the output with the supported manufacturer and product name combinations.
What extra capabilities do the included `asustor-it87` and `asustor-gpio-it87` modules provide?
The included `asustor-it87` module skips fan PWM sanity checks, supports more IT86XX and IT87XX chip variants, and can add timer-based blinking for up to two LEDs on some models. The `asustor-gpio-it87` module adds support for the IT8625E chip used in newer ASUSTOR devices.
Where are fan speed and front-panel LED brightness controls exposed?
Fan speed regulation is exposed through `pwm1` under `/sys/devices/platform/asustor_it87.*/hwmon/hwmon*/`, and front-panel LED brightness is adjusted via `pwm3`. An example `fancontrol` configuration is provided for an AS62 system.
Is there a safety warning about changing GPIO settings?
The project warns that changing GPIO input/output settings without knowing their effects can be dangerous and may lead to instability, corrupted data, or a broken system. Use the driver at your own risk.
Answers sourced from ca.unraid.net, github.com
Community
- New release: [Linux on ASUSTOR] asustor-platform-driver - Reddit (reddit)
- asustor - Reddit (reddit)
- [PLUGIN] asustor platform drivers - Plugin Support - Unraid (forum)
- ASUSTOR Community Forum - Index page (forum)
- asustor - Reddit (reddit)
- [Guide] Asustor fan control - User Customizations - Unraid (forum)
Collected 48 days ago - public community threads