UGREEN DXP NAS Driver for the system fan

After multiple searches I found a bunch of posts about loud fans for the DXP2800 but not how to control the fans. This applies to those who do not use UGOS PRO but unRAID, Debian, Ubuntu, Fedora etc.

Note

In cooperation with AI, we've upstreamed the driver for the it87 chipset for the latest linux kernel (April 2026), dropped old kernel support for kernel version 2.7.x since there will be no UGREEN NAS with such a low linux kernel available. Im not good with C so any help, bug fixings and reviews are highly welcome :-)

Here is a step by step guide on how to do this:

Package Requirements

• gcc
• make
• dkms
• dwarves
• kernel-headers
• lm_sensors
• git

System requirements to set up fan control

• SSH Client
• Basic knowledge with Linux and terminal commands

Install Guide (Automated)

The automated installer handles driver building via DKMS, systemd service setup, and configuration protection. It ensures the driver loads reliably after reboots and kernel updates, and guards against fancontrol configuration loss.

1. SSH into your UGREEN NAS

2. Install the required packages

# Fedora/RHEL
sudo dnf install gcc make dkms dwarves kernel-headers lm_sensors git

# Debian/Ubuntu
sudo apt install gcc make dkms dwarves linux-headers-$(uname -r) lm-sensors git

# Arch
sudo pacman -S gcc make dkms linux-headers lm_sensors git

3. Clone the repository and run the installer

git clone --recurse-submodules https://github.com/0n1cOn3/UGREEN-Fan-Control.git
cd UGREEN-Fan-Control
sudo ./scripts/install.sh

4. Detect sensors and configure fan control

sudo sensors-detect

You can answer all questions with Y.

Note

If you have previously executed lm_sensors and the dkms module has not yet been installed, you may see the following message:

Found `ITE IT8613E Super IO Sensors'                        Success!
(address 0xa30, driver `to-be-written')

That's normal behavior and will still appear even when the driver has been installed. The interface to the ventilation is now available.

5. Configure which fan uses which channel

sudo pwmconfig

This utility will create the fancontrol config file in /etc/fancontrol.

6. Enable and start the fancontrol service

sudo systemctl enable --now fancontrol

The installer automatically sets up systemd services that ensure:

• The it87 driver is loaded before fancontrol starts (prevents race conditions)
• The fancontrol configuration is backed up and restored if corrupted
• Device paths are updated automatically if they change after reboot

Install Guide (Manual)

Click to expand manual installation steps

1. SSH into your UGREEN NAS

2. Install the packages mentioned above like

sudo dnf install gcc make dkms dwarves kernel-headers lm_sensors

3. Building the dkms module and installing it

cd it87
make -j4
sudo make install

[!NOTE] If you see this: Skipping BTF generation [module name] due to unavailability of vmlinux.

You can simply run:

cp /sys/kernel/btf/vmlinux /usr/lib/modules/`uname -r`/build/

And clean up the previous, interrupted build and do a clean build from scratch

make clean && make -j4 && sudo make install

4. Testing and configure the fans by configuring lm_sensors

sudo sensors-detect

You can answer all questions with Y.

5. Configure fan channels with pwmconfig

sudo pwmconfig

This small application will take over for creating the fancontrol config file in /etc

6. Activate the fancontrol service at boot time

systemctl enable --now fancontrol

Uninstall

To remove the driver, services, and configuration files:

sudo ./scripts/uninstall.sh

This preserves your /etc/fancontrol configuration. Remove it manually if no longer needed.

Troubleshooting

Fan control stops working after reboot

The automated installer prevents this by setting up proper systemd service ordering. If you installed manually, ensure the it87 module is loaded before fancontrol starts:

# Check if the module is loaded
lsmod | grep it87

# Load it manually
sudo modprobe it87 ignore_resource_conflict=1

# Make it persistent across reboots
echo "it87" | sudo tee /etc/modules-load.d/it87.conf
echo "options it87 ignore_resource_conflict=1" | sudo tee /etc/modprobe.d/it87.conf

Configuration file is corrupted or missing

The automated installer includes a config guard that backs up and restores the configuration. To manually restore from backup:

sudo /usr/local/sbin/fancontrol-config-guard.sh restore

To recreate the configuration from scratch:

sudo systemctl stop fancontrol
sudo pwmconfig
sudo systemctl start fancontrol

DKMS module fails to build after kernel update

# Check DKMS status
dkms status it87

# Rebuild for current kernel
cd it87
make clean
sudo make dkms

Why did i that?

The idea for this project has been brought by this Reddit post

Who wrote the dkms module?

That was written by

• Copyright (C) 2001 Chris Gauthron
• Copyright (C) 2005-2010 Jean Delvare jdelvare@suse.de and archived by a1wong

Results

Tested with

# sensors-detect version 3.6.0
# System: UGREEN DXP2800 [EM_DXP2800_V1.0.25]
# Board: Default string Default string
# OS: Fedora 42 Server Edition
# Kernel: 6.14.5-300.fc42.x86_64 x86_64
# Processor: Intel(R) N100 (6/190/0)

root@lainpool:/# fancontrol
Loading configuration from /etc/fancontrol ...

Common settings:
  INTERVAL=10

Settings for hwmon2/pwm3:
  Depends on hwmon1/temp3_input
  Controls hwmon2/fan3_input
  MINTEMP=22
  MAXTEMP=60
  MINSTART=105
  MINSTOP=26
  MINPWM=24
  MAXPWM=255
  AVERAGE=1

sensors
it8613-isa-0a30
Adapter: ISA adapter
in0:         660.00 mV (min =  +0.00 V, max =  +2.81 V)
in1:           1.12 V  (min =  +0.00 V, max =  +2.81 V)
in2:           2.07 V  (min =  +0.00 V, max =  +2.81 V)
in4:           2.06 V  (min =  +0.00 V, max =  +2.81 V)
in5:           2.08 V  (min =  +0.00 V, max =  +2.81 V)
3VSB:          3.30 V  (min =  +0.00 V, max =  +5.61 V)
Vbat:          3.15 V  
+3.3V:         3.37 V  
fan2:           0 RPM  (min =    0 RPM)
fan3:        1726 RPM  (min =    0 RPM)
temp1:        +40.0°C  (low  = -128.0°C, high = +127.0°C)  sensor = thermistor
temp2:        +23.0°C  (low  = -128.0°C, high = +127.0°C)  sensor = thermistor
temp3:        +42.0°C  (low  = -128.0°C, high = +127.0°C)
intrusion0:  ALARM

acpitz-acpi-0
Adapter: ACPI interface
temp1:        +27.8°C  

coretemp-isa-0000
Adapter: ISA adapter
Package id 0:  +49.0°C  (high = +105.0°C, crit = +105.0°C)
Core 0:        +49.0°C  (high = +105.0°C, crit = +105.0°C)
Core 1:        +49.0°C  (high = +105.0°C, crit = +105.0°C)
Core 2:        +49.0°C  (high = +105.0°C, crit = +105.0°C)
Core 3:        +49.0°C  (high = +105.0°C, crit = +105.0°C)

Bugs

Please report them here.

Donations

It took me a few hours to prepare, testing and deliver this for you. :) I'll appreciate any contribution to the coffee fund :3

BTC: 3EdkooEbQJurjCHScwUjPHGCCszoFh1pmM

ETH: 0x0dB50ef6C03c354795e306133B71A69d8F2e9cc6