🚀 Getting Started

📦 Package Selection

CoolerControl consists of two packages: the main system daemon and an optional desktop application. The daemon will detect and control supported devices and includes a built-in Web UI. The desktop application offers full desktop integration and opens the daemon's UI in a window.

1. coolercontrold (required) - The system service daemon that handles controlling your hardware.
2. coolercontrol (optional) - A Desktop Application.
   (alternatively you can access the daemon's Web UI in your browser)

Optional package dependencies:

These are optional packages that improve CoolerControl's hardware support and are available for most distributions from their respective package repositories.

• liquidctl (optional) - A cross-platform tool and drivers for liquid coolers and other devices.
• lm_sensors (optional) - user-space support for the hardware monitoring drivers in Linux

For additional driver support, see the hardware support page.

🧰 Install for your Distro

• AppImage
• Arch / Manjaro / EndeavourOS / CachyOS
• Debian / Ubuntu / Mint / Pop!_OS
• Fedora / Nobara / Bazzite / Atomic
• openSUSE Tumbleweed / Slowroll
• NixOS / Nix
• Gentoo
• Unraid
• Docker
• From Source

🧙 Configure

Before you configure

Check Hardware Support to verify devices are detected and any required kernel modules are loaded. Undetected hardware cannot be controlled.

First Steps

The left menu lists all your detected devices and their controllable fans/pumps.

1. Create a Profile — go to Fan Profiles and create a new Graph Profile. Set the source temperature sensor (e.g. CPU, GPU) and shape the fan curve to your liking.
2. Assign the Profile to your fans — a Profile is not auto-assigned. You must apply it explicitly, either:
   • On the Controls Page — click a fan channel and select your Profile, or
   • On the fan's own settings page — click the fan in the left menu and assign it there.
3. Repeat as needed — one Profile can be reused across multiple fans, so you only need to create it once and assign it wherever you want the same curve applied.

• Reduce noise and load by disabling unused devices and sensors.
• ⭐ Basic Setup
  • 🎛️ Controls Page
  • 📈 Fan Profiles
  • 🧪 Functions
  • 📊 Dashboards
  • 🚨 Alerts
• 🎯 Advanced Setup
  • 🔀 Control Flow
  • 📟 Custom Sensors
  • 🥣 Mix Profiles
  • ⚖️ Overlay Profiles
  • 🔖 Mode switching
• See the Configure Menu 👈 for more configuration options

✨ Features

• Highly configurable GUI with dashboards
• System daemon runs in the background
• Control devices based on any temperature or combinations of sensors
• Auto-detection of hwmon/sysfs and liquidctl devices
• Enhanced liquidctl device support (AIOs, USB fan hubs, LCD screens, RGB lighting, etc.)
• GPU fan control for most NVIDIA and AMD GPUs
• Fully customizable Profiles (Fixed, Graph, Mix, Overlay) that can be applied to multiple fans
• Functions add hysteresis, thresholds, directionality, and response-time control
• System-wide cooling Modes to adjust all devices at once
• Custom Sensors from files or combinations of existing sensors
• Multiple Dashboards with filters for sensor data
• Alerts for temperature/fan anomalies
• Reapplies settings after sleep
• External monitoring and GUI support
• Headless support with a built-in Web UI
• Comprehensive REST API for integrations