From 9473b6e311640998c556f8740e13effa7724517f Mon Sep 17 00:00:00 2001 From: Seth Johnson Date: Fri, 17 Jul 2026 19:10:03 -0400 Subject: [PATCH] chore: add Community Applications submission files MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Adds the files needed to publish to Unraid Community Applications via ca.unraid.net/submit: - templates/only-fan-controller.xml — CA Docker template (Category Tools:Utilities, image ghcr.io/.../:latest, GitHub Issues support, TemplateURL, all env-var Config fields). GPU monitoring defaults OFF with no forced --runtime=nvidia so the container starts on CPU-only systems; GPU users enable it and add the runtime flag. - ca_profile.xml — CA repository profile (Profile / Icon / WebPage). Support routes to GitHub Issues (no forum thread needed under the new portal). Co-Authored-By: Claude --- ca_profile.xml | 6 +++++ templates/only-fan-controller.xml | 42 +++++++++++++++++++++++++++++++ 2 files changed, 48 insertions(+) create mode 100644 ca_profile.xml create mode 100644 templates/only-fan-controller.xml diff --git a/ca_profile.xml b/ca_profile.xml new file mode 100644 index 0000000..1ec4b12 --- /dev/null +++ b/ca_profile.xml @@ -0,0 +1,6 @@ + + + Only Fan Controller — intelligent, quiet fan control for Dell PowerEdge (iDRAC) servers, with optional NVIDIA GPU awareness and Home Assistant (MQTT) integration. Reads CPU temps over IPMI and GPU temps via nvidia-smi and drives the fans through the iDRAC, with a fail-safe hand-back to the BMC. Support is via GitHub Issues on the project repository. + https://raw.githubusercontent.com/sethpjohnson/only-fan-controller/main/icon.png + https://github.com/sethpjohnson/only-fan-controller + diff --git a/templates/only-fan-controller.xml b/templates/only-fan-controller.xml new file mode 100644 index 0000000..6f69ab7 --- /dev/null +++ b/templates/only-fan-controller.xml @@ -0,0 +1,42 @@ + + + only-fan-controller + ghcr.io/sethpjohnson/only-fan-controller:latest + https://ghcr.io/ + bridge + + sh + false + https://github.com/sethpjohnson/only-fan-controller/issues + https://github.com/sethpjohnson/only-fan-controller + Intelligent, quiet fan control for Dell PowerEdge (iDRAC) servers, with optional NVIDIA GPU awareness and Home Assistant integration. Reads CPU temperatures over IPMI and GPU temperatures via nvidia-smi, then drives the fans through the iDRAC's manual fan commands - quiet at idle, ramping under load, without the iDRAC's aggressive default curve. Fail-safe by design: if a sensor read or the process itself fails, fan control is handed back to the BMC so the server is never left uncooled. + Threshold-based fan controller for Dell PowerEdge servers (built and tested on an R730). **Features** - Threshold control with hysteresis (no fan oscillation) - CPU temps via IPMI (ipmitool); optional per-card GPU temps via nvidia-smi - Fail-safe: sensor/process failure hands cooling back to the BMC's automatic control - Real-time web dashboard + JSON API - Optional Home Assistant integration over MQTT (auto-discovery: per-GPU temperature/utilization/power, fan-speed control, availability) **Requirements** - A Dell server with iDRAC reachable on the network (IPMI over LAN enabled). Fill in the iDRAC Host / Username / Password fields. **NVIDIA GPU (optional)** - To monitor GPU temps: set "Enable GPU Monitoring" = true AND add `--runtime=nvidia` to Extra Parameters (requires the Unraid NVIDIA Driver plugin). Leave both off on CPU-only systems. **Note** - While running, this puts the iDRAC in manual fan mode; see the project's README Safety section. Support via GitHub Issues. + Tools:Utilities + http://[IP]:[PORT:8086]/dashboard/ + https://raw.githubusercontent.com/sethpjohnson/only-fan-controller/main/templates/only-fan-controller.xml + https://raw.githubusercontent.com/sethpjohnson/only-fan-controller/main/icon.png + + + + + + + + 8086 + + root + + + false + + + + false + 20 + 65 + 60 + 10 + 60 + 10 + /mnt/user/appdata/only-fan-controller/data +