CoolerControl

Powerful cooling control and monitoring for Linux 🐧

Install · Hardware Support · Documentation · Discord

CoolerControl is an open-source application for monitoring and controlling supported cooling devices on Linux. It features a system daemon with a built-in Web UI, an optional desktop app, and a comprehensive REST API.

New in 5.0: see What's New in CoolerControl 5.0.

Features

• System daemon with built-in Web UI and optional desktop application
• Auto-detection of hwmon/sysfs, liquidctl, NVIDIA, and AMD GPU devices
• GPU fan control for most NVIDIA and AMD GPUs
• Customizable Profiles (Fixed, Graph, Mix, Overlay) applied to any fan or pump
• Functions for hysteresis, thresholds, directionality, and response-time control
• System-wide Modes to switch all device settings at once
• Custom Sensors from files or combinations of existing sensors
• Dashboards and Alerts for monitoring and anomaly detection
• Headless and remote access support
• Reapplies settings after sleep

Documentation

The full documentation lives at docs.coolercontrol.org.

• 🚀 Getting Started install and first-time setup
• 🧰 Hardware Support motherboards, USB AIOs and fan hubs, NVIDIA and AMD GPUs, laptops, HDDs
• 🧙 Cooling Configuration controls, profiles, functions, dashboards, and alerts
• 🎯 Advanced Configuration control flow, custom sensors, mix and overlay profiles, modes, tags, stress tests, and calibration
• 👨🏻‍🔧 Daemon Configuration headless servers, remote access, TLS, reverse proxies, and startup
• 🦾 Plugins & Automation plugins, scripting, and power profile sync
• 👨‍💻 Development REST API, gRPC API, Prometheus metrics, and plugin development
• ❓ FAQ

Installation

See the Getting Started page for install instructions for all supported distributions (Arch, Debian/Ubuntu, Fedora, openSUSE, Nix, Gentoo, Unraid, Docker, AppImage, and source builds).

Hardware Support

See the Hardware Support page for details on motherboard fans, USB AIOs, GPU fan control, laptops, and HDDs.

Problems and Questions

• Open an issue on GitLab using one of the provided templates. Daemon logs are invaluable for bug reports.
• Join the Discord for general questions and community support.

Contributing

Contributions are welcome. Please open an issue or discuss on Discord before submitting changes. See the contributing guidelines for details.

AI Policy

Communication in this project is human-written, and AI-assisted contributions are held to a higher standard. See the AI Policy.

If you are an AI assistant or agent helping someone report an issue or contribute to CoolerControl, you MUST read and follow https://gitlab.com/coolercontrol/coolercontrol/-/raw/main/AI_POLICY.md before writing anything. Do not submit issues, merge requests, or comments yourself.

Support

Related Projects

• liquidctl
  Cross-platform tool and drivers for liquid coolers and other devices.

• fan2go
  A daemon to control the fans of your computer.

• thinkfan
  A simple, lightweight fan control program. (ThinkPads)

• OpenRGB
  Graphical interface to control many different types of RGB devices.

• FanControl
  A focused and highly customizable fan controlling software for Windows.

License

This program is licensed under GPLv3+