Repository navigation
Releases
Releases · sethpjohnson/only-fan-controller
v1.2.1
v1.2.0
This release adds Home Assistant integration over MQTT (auto-discovery) with per-GPU temp / utilization / power sensors and fan control straight from HA.
Plus a round of fail-safe hardening so the server is never left uncooled as well as security updates.
v1.0.0 - Initial Release
🌀 Only Fan Controller v1.0.0
Initial public release!
Features
- Simple threshold control - Set CPU/GPU temperature thresholds, fans increase when exceeded
- Hysteresis - Configurable cooldown delay prevents fan oscillation
- Workload hints API - External scripts can signal upcoming load for proactive cooling
- Real-time dashboard - Web UI with temperature graphs and threshold visualization
- Unraid ready - Template included, no config file needed
Configuration
All settings via environment variables:
FAN_IDLE_SPEED- Base fan speed (default: 20%)FAN_CPU_THRESHOLD- CPU temp threshold (default: 65°C)FAN_GPU_THRESHOLD- GPU temp threshold (default: 60°C)FAN_COOLDOWN_DELAY- Seconds before ramping down (default: 60)
Quick Start
docker run -d --gpus all -p 8086:8086 \
-e IDRAC_HOST=192.168.1.100 \
-e IDRAC_PASSWORD=yourpassword \
ghcr.io/sethpjohnson/only-fan-controller:latestDashboard: http://localhost:8086/dashboard/