🚀 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
• Ubuntu/Debian Based
• Fedora
• openSUSE
• Gentoo
• Nix
• Unraid
• Docker
• From Source

🧙 Configure

• If CoolerControl doesn't detect your hardware, see Hardware Support first.
• 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