Skip to content
On this page

Updated at:

Startup โ€‹

The CoolerControl daemon (coolercontrold) is managed by systemd on most Linux distributions. This page covers how to control the daemon's startup behavior.

Service Management โ€‹

Start the Daemon โ€‹

bash
sudo systemctl start coolercontrold

Stop the Daemon โ€‹

bash
sudo systemctl stop coolercontrold

Restart the Daemon โ€‹

bash
sudo systemctl restart coolercontrold

Check Status โ€‹

bash
sudo systemctl status coolercontrold

Enable/Disable Automatic Startup โ€‹

Enable at Boot โ€‹

To have the daemon start automatically at boot:

bash
sudo systemctl enable coolercontrold

Disable at Boot โ€‹

To prevent the daemon from starting automatically at boot:

bash
sudo systemctl disable coolercontrold

Check if Enabled โ€‹

bash
sudo systemctl is-enabled coolercontrold

Startup Delay โ€‹

If you need to delay the daemon startup, such as to allow more time for devices to come up at boot, CoolerControl has a built-in setting for that so there's no need to use i.e. a sleep function.

Viewing Logs โ€‹

To view the daemon's startup logs:

bash
sudo journalctl -u coolercontrold

For real-time logs:

bash
sudo journalctl -u coolercontrold -f

For logs since last boot:

bash
sudo journalctl -u coolercontrold -b

Troubleshooting Startup Issues โ€‹

If the daemon fails to start:

  1. Check the status and logs:

    bash
    sudo systemctl status coolercontrold
    sudo journalctl -u coolercontrold -n 100
  2. Verify configuration file syntax:

    bash
    sudo coolercontrold --config
  3. Check for port conflicts:

    bash
    sudo netstat -tlnp | grep 11987

Restart on Failure โ€‹

The daemon systemd service is configured to restart automatically on failure.

See Also โ€‹

Released under the GPLv3+ License.