# CoolerControl

CoolerControl is a fan, pump, and RGB (red, green, blue) lighting and monitoring application for Linux. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/210/coolercontrol

## Description

CoolerControl is a fan, pump, and RGB (red, green, blue) lighting and monitoring application for Linux. It can run as a headless daemon with a web interface and supports device monitoring, alerts, plugins, metrics, and automation. It is useful for Linux desktops, servers, and homelab systems that need controlled cooling or custom fan curves.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

64/100 (Good), based on 4 of 5 factors.
- Maintained: 78 (last commit 42 days ago)
- Popular: 50 (321 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 85 (no serious findings, CI)

## Links

- GitHub: https://github.com/SasaKaranovic/OpenFanController
- Docker Hub: https://hub.docker.com/r/coolercontrol/coolercontrold
- Unraid: https://ca.unraid.net/apps/coolercontrol-1ai3hyh156vcv1?q=CoolerControl
- Official website: https://sasakaranovic.com/projects/openfan-controller

## Common questions

### Does CoolerControl run headless for a remote web interface?

The daemon is headless by default and serves its own Web UI. It supports remote access, TLS, reverse proxies, and multiple hosts.

### Why do I get 'Device or resource busy' on Unraid?

Disable BIOS fan control so the BIOS is not also trying to control the fans. This is the common fix for the 'Device or resource busy' error.

### Why don't my fans appear after installing CoolerControl?

A reboot after installation can make the fans appear in the app. One user found that following the install steps and rebooting resolved the issue.

### Should I base fan curves on CPU temperature or liquid temperature?

In most setups, liquid temperature changes more slowly than CPU temperature, which can produce smoother and quieter control. Choose based on your hardware, noise, and thermal goals.

### Why won't CoolerControl start on a normal Linux distro using Nix?

If you are not on NixOS, create /nix with admin rights and point it at your local Nix package folder. Without that link, CoolerControl may not find its files and can fail to start.

---
Source: Our Local Host (https://ourlocalhost.com/app/210/coolercontrol), the self-hosted and open-source app directory.
