# Only Fan Controller

Only Fan Controller is a self-hosted infrastructure app. Quiet, threshold-based fan control for Dell PowerEdge (iDRAC) servers, with optional NVIDIA GPU monitoring and Home Assistant integration. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3151/only-fan-controller

## Description

Quiet, threshold-based fan control for Dell PowerEdge (iDRAC) servers, with optional NVIDIA GPU monitoring and Home Assistant integration.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

46/100 (Fair), based on 4 of 4 factors.
- Maintained: 63 (last commit 126 days ago)
- Popular: 14 (4 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 70 (1 GB minimum RAM)

## Links

- Unraid: https://ca.unraid.net/apps/only-fan-controller-0frbxrp0x3rjr5?q=Only-Fan-Controller

## Common questions

### How do I enable NVIDIA GPU temperature monitoring in Docker?

Run the container with GPU access enabled by using --gpus all and setting NVIDIA_VISIBLE_DEVICES=all. GPU temperatures are read with nvidia-smi.

### Which host files and directories should be mounted for configuration and data?

Mount config.yaml read-only to /etc/only-fan-controller/config.yaml and a host data directory to /var/lib/only-fan-controller.

### How does the controller increase and decrease fan speed around thresholds?

Fans run at idle_speed below the CPU and GPU thresholds and increase by step_size for every 5 degrees C above the threshold. Fans ramp down only after temperatures remain below thresholds for cooldown_delay seconds.

### What happens if the controller exits unexpectedly?

The shutdown path restores automatic iDRAC fan mode before the process exits. If a config fails safety validation, the process refuses to start instead of enabling unsafe manual mode.

### Can external scripts make the controller cool proactively?

Yes, the Workload Hints API lets external scripts set a minimum fan speed floor before a workload starts.

---
Source: Our Local Host (https://ourlocalhost.com/app/3151/only-fan-controller), the self-hosted and open-source app directory.
