CoolerControl
coolercontrol/coolercontrold
https://hub.docker.com/r/coolercontrol/coolercontrold
bridge
sh
false
https://forums.unraid.net/topic/188566-support-coolercontrol-in-docker/
https://gitlab.com/coolercontrol/coolercontrol
https://docs.coolercontrol.org/installation/unraid.html
CoolerControl is a feature-rich fan and RGB control and monitoring application for Linux.
Visit https://docs.coolercontrol.org/installation/unraid.html for information on setting this container up properly.
You may encounter issues setting up this container on Unraid versions below 7.0.1.
https://gitlab.com/coolercontrol/coolercontrol/-/raw/main/screenshots/coolercontrol-overview.png
https://gitlab.com/coolercontrol/coolercontrol/-/raw/main/screenshots/coolercontrol-speed.png
https://gitlab.com/coolercontrol/coolercontrol/-/raw/main/screenshots/coolercontrol-lighting.png
Drivers: Tools:
http://[IP]:[PORT:11987]/
https://gitlab.com/coolercontrol/coolercontrol/-/raw/main/coolercontrol/icons/Square310x310Logo.png
/mnt/user/appdata/coolercontrol
11987
/sys/class/hwmon
11987
0.0.0.0
::
OFF
# 2026.05.11 (CoolerControl v4.3.0)
### Added
- Time Average custom sensor for smoothing temperature inputs over a configurable window (#456,
!485)
- EMA custom sensor that will gradually replace the EMA Function type (!485)
- "Bypass Min at Extremes" Function setting for fan curves (!484)
- Theme code support for exporting and importing custom UI themes via short codes (!488)
- Choose startup page setting, defaulting to Info and Tools (!481)
- Channel in-use as temp source check before disabling, with detailed error message (!483)
- Curve point limit hints shown in the Profile View and fan control wizards (!481)
- Failsafe fallback values are now used for missing Custom Sensors sources
- Streaming extractors and per-channel staleness ticking for hwmon devices, so only stale channels
fall back to failsafe values (!479)
- Round-robin sensor reading, per-read permits that interleave reads with writes, and coalesced fan
writes for hwmon devices to improve slow device handling (!480)
- Duty cache and command deduplication to reduce redundant work on slow hwmon and liquidctl devices
(!480)
- Concurrent application of startup and wakeup device settings (!480)
- Hwmon initialization timeout so a broken device cannot hang daemon startup (!480)
- Pending operation cancellation on shutdown (!480)
- Hwmon raw read debug logs and runtime error logging for power and temp sensors
- Unmanaged and Read-only subtext for appropriate fan channels in the main device menu
### Changed
- Default Profile renamed to "Unmanaged" and surfaced as a separate setting rather than a Profile,
with reduced visual priority in the menu and applicable fan settings (!481)
- Tour steps rewritten and reordered, with two tour options: quick and thorough (!481)
- General settings renamed to User Interface settings (!481)
- Auto-created "My Profile" and "My Function" are no longer added on first start (!481)
- Session expiry extended, and the UI now refreshes automatically when the session cookie expires
(!482)
- Login lockout and reset-password flows hardened against edge cases (!482)
- `plugins_dir` is now derived from `data_dir`, so overriding `data_dir` is sufficient for most
setups
- Tooltip styling refined (alignment, single-pixel table separators, softer borders)
- Improved hwmon shutdown resilience, sleep handling that no longer blocks the daemon loop, and
better handling of blocking ioctl calls for drivetemp (!479)
- Improved Forgot Password link (!482)
- Added mini getting started steps to the Tour and Info & Tools page
- Aligned and centralized timeouts throughout the daemon
- Decoupled hwmon read permit timeouts from poll rate, allowing slow devices more time to respond
before timing out
- Many upstream dependencies updated
### Fixed
- Thinkpad dGPU temp sensor error when the GPU is powered off (!486)
- Failsafe values are now correctly applied for failed hwmon reads, and missing fan duty/rpm returns
cached or failed values instead of none (!479)
- Overlay and Mix profiles now output a duty right away when first applied to an additional fan
channel
- Disabled devices are excluded from new-device detection (best effort) (!480)
- In-flight hwmon writes now pick up the newest waiting value instead of an older one (!480)
- Forgot Password link is shown when changing the password (!482)
- Aqua initialization log only shown once instead of repeatedly
- Read-only fan tooltip, popover style, and stacking emitters
- Missing alert settings in the wizards and various small style alignment issues
# 2026.04.22 (CoolerControl v4.2.1)
### Changed
- Stress-ng capability checks at startup removed, users choose which stress tests to run (#572,
!477)
- Watchdogs added to ensure stress-ng processes are cleanly killed in edge cases
### Fixed
- Potential hang when D-Bus does not respond (!478)
- Several issues on some systems with stress-ng
- UI cache is no longer cleared on version mismatch, which could cause an issue.
# 2026.04.21 (CoolerControl v4.2.0)
### Added
- Automatic detection of added or removed devices at runtime, with desktop notifications via SSE and
browser push support (!455)
- Built-in CPU, GPU, RAM, and drive stress tests for easy profile and fan curve validation, using
stress-ng when available (!453)
- Full-page views for plugins, a dedicated Plugins overview page, plugin enable/disable, and
alphabetical ordering (!458)
- Sensors Detect and device change detection toggles in settings (!457)
- Plugin data proxy for safely retrieving custom data from plugin services (!473)
- Allow Fixed profiles as members of Mix profiles (!471)
- Advanced Device Setting for per-device Command Delay to handle device timing issues (!465)
- Control Flow interactivity improvements: clamp to content, panning limits, separate columns for
parents and children, more space for large charts, and switching profile sources directly from
profile and fan nodes (!463)
- Support for the liquidctl ga2lcd device driver (#571, !464)
- NVIDIA GPU hotspot temperature reporting (!456)
- Advanced Device Setting to enable AMD GPU Overdrive at the kernel level with improved amdgpu
logging (!474)
- Thinkpad auto-mode switch on system suspend as a workaround for hardware issues (#550, !459)
- Improved Alert Logs: better handling of hard shutdowns and restarts, larger retention, search
input, and paginator at the top (!452)
- Log filter query parameter on the standard LCD settings API (!466)
- Detected channels and temperatures now included in device info log output (!468)
- "What's New" link in the UI pointing to the changelog (!461)
- Animated logo driven by the UI eye candy setting
- Versioned cargo vendor release asset (!448)
- Guidance for viewing plugin service logs across supported init systems (!472)
### Changed
- Plugin data and session data moved to a dedicated data directory, separate from config (!451)
- Alert log directory moved to the data directory (!452)
- OpenRC systems now use service-daemon for plugin service management (!472)
- Hwmon and liquidctl devices now use shared failsafe metric values (!455)
- Thinkpad device settings moved into the Advanced Device Settings popover
- Switched the daemon's TLS backend to ring for broader platform compatibility
- Reduced some liquidctl startup warnings to info level for CoolerControl logging
- liqctld processes now runs unbuffered for improved log output
### Fixed
- Issue when a service plugin device channel failed at startup left data missing (!467)
- Skip device port scanning when Secure Boot is enabled, logging info instead of a warning (!454)
- Failsafes are now also applied to hwmon fan-only devices (!465)
- NixOS hwdata pkg-config path resolved at build time (!449)
### Security
- Updated various dependencies with security advisories
# 2026.03.22 (CoolerControl v4.1.0)
### Added
- Tags for fans, displayed in the main menu and used for applying profiles/filters (#295, !436)
- Prometheus metrics endpoint (#366, !431)
- Access Token write access toggle (!434)
- Support for liquidctl ControlHub driver (#559, !433)
- Qt App and daemon version comparison dialog, helping with system package updates (!434)
- Auto-responsive Controls view (!437)
- Control Flow button and icon in the navigation (!437)
- Fast drawer for changing Control Flow node settings (!437)
- Mode name display in main menu on LCD and lighting channels (!443)
- Handling for more pwm auto no-read cases (dell_smm) (#557, !440)
- New password dialog flow with improved UX (!438)
### Changed
- Control Flow charts now shown for manual and default settings (!441)
- Channel Control Flow pans on scroll instead of zooming, consistent with other pages (!437)
- Improved default profile info message (!441)
- Improved Command usage in the Qt desktop app (!434)
- Consolidated config file paths with environment variable override support (!438)
- Replaced some dependencies with a custom implementation (!438)
- Improved triple EMA smoothing algorithm for fan control stability (!438)
- Improved temperature and duty-based function processing to reduce oscillation (!444)
- Tweaked release profile: use thin LTO for faster builds with minimal performance difference (!438)
- Build codegen-units set to an optimized in-between value (!438)
- Adjusted udevadm settle timeout and logging (!437)
- Improved shell command logging, de-escalating non-critical errors (!437)
- Make forgot password tooltip more obvious (!434)
- Token dialog styling improvements (!434)
- Small bump in allowed password attempts in short period (!434)
- Various dependency updates (!438)
### Fixed
- Stall issue with function small fan steps and downward_only settings (!444)
- Duty comparison used with temps in standard function processing to prevent edge cases bypassing
downward hysteresis settings (!444)
- Eye candy animation dashboard bug when zoomed in, where underlying data kept updating (!444)
- Console warnings about not found component (!444)
- Stack size sometimes off by one, which could introduce a delay in fan application (!444)
- Entire point entry in points table is now clickable for easier selection (!443)
- New devices now appear at the top of the menu (!443)
- Issue when Mix profiles are assigned to channels and members of other mix profiles (#565, !439)
- Plugin shutdown error on system shutdown when systemd has already stopped it (!437)
- Click propagation issue with sub-popovers (!436)
- Missing status readings for the Aquacomputer D5 (#560, !432)
### Security
- Local patch applied for time crate stack exhaustion vulnerability (RUSTSEC-2026-0009) (!442)
# 2026.03.09 (CoolerControl v4.0.1)
### Fixed
- Issue with bundled UI assets put in wrong directory
# 2026.01.10 (CoolerControl v3.1.1)
### Changed
- excluded it87 driver when detecting firmware profile support (not working)
- expose gRPC port by default in docker images
- plugin UI improvements
- changed default socket location for device service plugins
- various dependency adjustments to help with packaging efforts
### Fixed
- long standing issue with a held-back dependency
- unprivileged plugin service user should be a system user
# 2026.01.04 (CoolerControl v3.1.0)
### Added
- support for applesmc and macsmc-hwmon drivers
- Advanced Device Settings per device
- direct-access device setting for all liquidctl devices that also have a hwmon driver
- convience device setting for swapping driver types
- support for dynamic CPU Cores (#529)
- plugin system (beta) for device and integration services
- ability to connect multiple daemons together (read-only)
- groundwork layed for plugins to extended functionality and integration with other services
- additional Alert options: notifications, audio, shutdown
- system tray icon displays badge when alert or error is present
- information tooltip when using a Default Profile to explain it's effects on various device drivers
- new Function settings: asymmetric and fixed step sizes, plus threshold hopping toggle
- channel and entity names can now be directly edited directly on their respective pages by clicking
on them
- device and entity menu drop-down border colors
- mobil menu and drawer for smaller screens
### Changed
- improved support for liquidctl Corsair PSU drivers (#530)
- improved resilience, logging, and retry behavior for liquidctl devices at boot. (#531)
- improved handling of Kraken bucket errors (#532)
- alert states are always reevaluated on startup (#489)
- improved UI asset caching
- UI asset compression by default
- improved handling of slow connections to the UI
- app info page and log view improvements, including auto-scroll to bottom and an expand view
button.
- improved various description and tooltips text throughout the app
### Fixed
- Aura LED device issues at startup (#531)
- move-to-top issue with pinned menu items
- issue where using the move-top-top buttons didn't save the menu state
- various Gnome related issues around notifications and the system tray
- default device colors not changing with theme change
# 2025.11.04 (CoolerControl v3.0.2)
### Added
- firmware profile support for various HWMon drivers (!366)
- simulated zero-rpm mode for Nvidia GPUs that don't support 0% manual fan speed (#523)
### Changed
- minor liqctld improvements (!363)
- improved downstream packaging support (!364, !365, !369)
- improved UI reconnection logic (!368, #520)
### Fixed
- legacy Asetec/Kraken device support (#515)
- liqctld shutdown issue (!367)
# 2025.10.05 (CoolerControl v3.0.1)
### Changed
- improved multiple-UI reconnection handling
### Fixed
- liqctld service failure affecting some liquidctl devices
- RPM warning about unversioned obsoletes
# 2025.10.04 (CoolerControl v3.0.0)
### Removed
- The `coolercontrol-liqctld` package and service has been removed. The service has now been
embedded in the `coolercontrold` daemon as a child process (!340)
### Added
- Overlay Profiles: Advanced offset controls on top of base Profiles (!347)
- Custom Sensor Offset and parent-child chaining (!346)
- Custom Profile temperature ranges (!344)
- Ability to import and export color schemes
- API changes to help 3rd party integrations
- Keyboard shortcuts for common navigation (!349)
- New device/main menu: drag and drop device and sensor sorting, pinned sensors, host name,
additional submenu options, color control for device and entity titles, and improved usability and
performance (!339)
- Firmware-controlled profile support for some AMDGPUs and liquidctl devices. (hwmon device support
coming soon) (!354)
- Foundation for more advanced device and channel specific controls
- Min and Max CPU core frequency metrics
- Mix Profile difference mix function (!348)
- Ability to change liquidctl log level with environment variable
### Changed
- New Color Picker UI component
- Various logging improvements
- the `liqctld` service logs are now unified with the daemon's normal log output
- Nearly all dependencies upgraded, including several major version changes
- Website and documentation improvements
- Improved metric standards in the UI (!345)
- UI Performance and reloading improvements
### Fixed
- Issue with 24h time format
- Issue with minimum fan duty threshold (!338)
- Various minor bugs and UI issues
# 2025.07.20 (2.2.2)
## CoolerControl Changes
### Added
- Support for devices that only have non-controllable fans (#465)
- aarch64/arm64 & musl build support (!327, #475)
- Support for raspberry cpus
- DockerHub builds
- Alert warmup duration (#466)
- Show all sensors with chart toggle (#480)
- Show running instance when starting desktop app (#453)
### Changed
- Updated dependencies
### Fixed
- liquidctl Coolit driver support (#467)
- Hover menu not displaying correctly (#468)
- ThinkPad full-speed mode not disengaging (#470)
- Daemon status translation key
- Duplicate welcome text (#477)
- Minor Alerts related issues
[View full release notes](https://gitlab.com/coolercontrol/coolercontrol/-/releases/2.2.2)
# 2025.06.15 (2.2.1)
## CoolerControl Changes
### Added
- Improved security and quality checks for the GitLab CI Pipeline
### Changed
- Improved test coverage for main control engine
- Updated copyright year
### Fixed
- Disabled support for AsusRyujin liquidctl driver (#457)
### Security
- Vulnerability issue with dependency
[View full release notes](https://gitlab.com/coolercontrol/coolercontrol/-/releases/2.2.1)
# 2025.06.01 (2.2.0)
## CoolerControl Changes
### Added
- Support for older Intel CPUs (#437)
- Support for liquidctl MPGCooler driver (#436)
- Support for liquidctl AsusRyujin driver (#441)
- Support for liquidctl Coolit Hydro GT driver (#442)
- Zero Temperature Drive Power State (#443)
- Project Vision document
- International Language support i18n (!296 @kuilei0926)
- Fan control and entity creation wizards
### Changed
- Dependencies updated
- Reduce log level for drivetemp slow devices
- Improved code documentation and log messages
- Various minor implementation improvements
- UI Refresh no longer needed for theme changes (!296 @kuilei0926)
- Load libdrm_amdgpu dynamically
### Fixed
- Added liquidctl initialization retries and max startup delay (#438)
- Badge links in docs (!304 @pallaswept)
- Daemon crash in some rare situations
- Minor OpenAPI documentation (!301 @caferen)
- Missing metrics for single Dashboards
- Long float values in Alert logs
[View full release notes](https://gitlab.com/coolercontrol/coolercontrol/-/releases/2.2.0)
# 2025.04.12 (2.1.0)
## CoolerControl Changes
### Added
- New Icons including symbolic icon
- Zero RPM feature support for RDNA3/4 AMD GPU fan control - kernel version dependant
- Improved RDNA3/4 AMD GPU support, logs and docs
- Nvidia fan RPM support - upstream work
- Support for general HWMon device Power metrics (watts)
- Full-screen support for Web UI & Desktop app
- Full-Page feature for Dashboards
- Enhanced system information logs by default
- Link to Hardware Support docs in Device Settings
### Changed
- Continued log improvements for various situations
- Fallback icon logic and badge icon placement improvements
- Improved liqctld unix socket connection pool handling
- Improvments to Startup Tour
- Dependencies updated
- Build pipeline updates
### Fixed
- Issue when setting AseTek AIOs as either modern or legacy versions
- Handling for devices that do not have a writable pwmN_enable for fan control
- Issue on some systems with socket connection issues (#424)
- Issue where changing the Profile Type didn't count towards unsaved changes
- Minimum Profiles reqiured for Mix Profiles are now properly evaluated
[View full release notes](https://gitlab.com/coolercontrol/coolercontrol/-/releases/2.1.0)
# 2025.03.31 (2.0.1)
- Initial release