How to Install CoolerControl on Your Linux Distribution

CoolerControl is a Linux cooling control application, and installation is distribution-specific: follow the guide for your distro, then confirm your hardware is detected and let the Auto-Create wizard build a working setup. The official documentation at docs.coolercontrol.org is the entry point — its "New here?" section points you to install instructions for your distribution, and its "Is my hardware supported?" and "Setting up cooling?" sections cover the checks that follow.

Before you start

• Know your distribution and package manager. The install path differs between distros, so identify yours first (for example, a Debian/Ubuntu-based system versus a Fedora-based one).
• Have your hardware details handy. You will want to confirm that your fans, pumps, and temperature sensors are detected after installation.
• Use the official documentation as your source. The site's Getting Started material is organized around the three steps below, so follow it rather than third-party instructions that may be out of date.

Step 1: Install for your distribution

Open docs.coolercontrol.org and go to the "New here?" / Getting Started section. It directs you to install for your distribution. Select the guide that matches your system and follow its steps exactly — package names and commands are not interchangeable between distros.

Expected result: CoolerControl is installed and its service or application is available on your system.

Common snag: Using a guide written for a different distribution. If a package name or command is not found, go back to the documentation and confirm you are on the correct distro page.

Step 2: Verify your hardware is detected

Once installed, check that CoolerControl sees your cooling hardware. The documentation addresses this directly under "Is my hardware supported?" — use that section to confirm your fans, pumps, and sensors appear.

Expected result: Your cooling devices and temperature sensors are listed in the interface.

Common snag: A device that does not appear. This usually means the hardware is not supported or a required kernel driver or module is not loaded; the hardware-support section is the place to check before troubleshooting further.

Step 3: Let the Auto-Create wizard build a setup

With hardware detected, run the Auto-Create wizard. As described in the documentation, it builds a working cooling setup for you, which gives you a functioning baseline before you fine-tune anything.

Expected result: A working cooling configuration is generated and applied.

Common snag: Skipping this step and configuring everything by hand first. Starting from the wizard's output makes it easier to see what a valid setup looks like before you adjust curves or fan assignments.

Where to go next

The documentation's main sections map to the tasks above:

If you are still asking "What is CoolerControl?" — it is the application these steps install: a tool for taking control of your cooling on Linux. Work through the three steps in order, and use the matching documentation section whenever a step does not produce the expected result.