Asustor Platform Drivers

Linux kernel driver plugin for Unraid that adds LED and button hardware support to ASUSTOR NAS systems.

  • Drivers
  • Infrastructure
  • Plugins
  • Productivity
  • Tools & Utilities
Linux kernel driver plugin for Unraid that adds LED and button hardware support to ASUSTOR NAS systems. It exposes the IT87 chip and CPU GPIOs (general-purpose input/output pins) ASUSTOR uses for front-panel controls so Unraid can recognize LEDs and buttons instead of leaving them unsupported. Intended for self-hosters running Unraid on ASUSTOR NAS hardware who want working front-panel indicators and button events.

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

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

Collected 48 days ago - public community threads