coolercontrol/coolercontrold repository overview

⁠Official CoolerControl Daemon Images

⁠Documentation⁠ - Source Code⁠ - Contributing⁠

These images contain the system daemon and make the Web UI available on port 11987 from the image.

Supported architectures:

• amd64
• arm64/aarch64

Tags:

• latest⁠ , 4.3.1⁠
• alpine⁠ , alpine-latest⁠ , alpine-4.3.1⁠
• beta-* tagged images are for testing only

Note: The GUI application is not required to run CoolerControl, which is a convenience desktop application that connects to the daemon's web UI.

If full desktop integration is desired, it's recommended to install the applicable system packages⁠.

⁠🛠️ How to use this image

The simplest way to get started is by using privileged mode. However, this is not recommended, as it grants the container unrestricted access to the host system.

CoolerControl requires read and write access to your hardware devices. While privileged mode allows this by default, it's possible to grant access more securely by enabling permissions for specific system devices instead.

For guidance on how to set this up without using privileged mode, refer to the Unraid documentation⁠.

⁠Simple Example

docker run --privileged -p 11987:11987 coolercontrol/coolercontrold

Note: privileged mode is required to enable full control of the host's hardware. Use at your own risk.

⁠Persistent Configs

docker run --privileged -p 11987:11987 -v /etc/coolercontrol:/etc/coolercontrol coolercontrol/coolercontrold

⁠Enable NVidia fan control

docker run --privileged -p 11987:11987 -v /etc/coolercontrol:/etc/coolercontrol --gpus all --runtime nvidia coolercontrol/coolercontrold

Then open the Web UI⁠ at http://localhost:11987/

For more information see the documentation⁠.

⁠📝 License

This program is licensed under GPLv3+⁠