⚙️ Configuration Files

Backup and Restore

Like most Unix-like system services, the daemon's configuration lives under /etc. For CoolerControl it is specifically under /etc/coolercontrol/.

To create a complete backup of your daemon configuration:

sudo tar -czvf coolercontrol-backup.tgz /etc/coolercontrol

To restore from a backup (overwriting existing files), stop the daemon first, then extract, and start the daemon again:

sudo systemctl stop coolercontrold
sudo tar -xvf coolercontrol-backup.tgz -C /
sudo systemctl start coolercontrold

Quick backup of only the CoolerControl daemon and UI configuration files:

sudo coolercontrold --backup

See the command output for the destination path.

Daemon configuration files

/etc/coolercontrol/

The key files are:

• config.toml — daemon configuration (TOML; preserves comments). Manual edits are generally not recommended because many settings are interdependent and the UI manages them safely. If you do edit it, stop the daemon, update the file, then start the daemon again:

  sudo systemctl stop coolercontrold
  sudo nano /etc/coolercontrol/config.toml
  sudo systemctl start coolercontrold

• config-ui.json — shared UI settings (used by both the Web UI and Desktop application). Not intended for manual editing.

• modes.json — saved Mode settings.

• alarms.json — saved Alarm settings.

There are additional files in this folder that the daemon uses, but the ones above are the primary ones.

TIP

Need to start fresh? First make a backup, then remove /etc/coolercontrol/ and restart the daemon and UI to regenerate defaults. This is destructive—only do this if you intend to reset all settings.

The current default daemon config file is located here.

Desktop application configuration files

Desktop config file: ~/.config/org.coolercontrol.CoolerControl/CoolerControl.conf

Local storage for the desktop app is stored here:
~/.local/share/org.coolercontrol.CoolerControl/CoolerControl/

Editing desktop config files manually is generally unnecessary, prefer using the application UI. If you must edit manually, close the app first and restart it after saving changes.