putnam
superfans
Python

Tools for managing fans on Supermicro chassis

Last updated May 14, 2026
68
Stars
9
Forks
0
Issues
0
Stars/day
Attention Score
1
Language breakdown
Python 100.0%
โ–ธ Files click to expand
README

superfans

Tools for managing fans on Supermicro chassis via IPMI.

This has been tested successfully on X10 and X11 boards as well as the CSE-PTJBOD-CS3 management board. Please report compatibility issues at: https://github.com/putnam/superfans/issues

Requires ipmitool, python3 and click (pip3 install click)

Usage: superfans [OPTIONS] COMMAND [ARGS]...

Tools for managing fans on a Supermicro chassis.

Fan presets can be adjusted, or fans manually updated to a certain speed.

If a hostname is specified, superfans will use the specified username and password to connect. If a hostname is not specified, ipmitool will talk to the local machine using the IPMI kernel module.

When setting fan speed manually, the fan preset must be set to Full, or else the hardware fan controller will automatically adjust the speed again after some time has passed.

For a list of presets, use superfans preset --help.

If needed, the hostname, username, and password options should precede commands. A hostname of "localhost" (the default) will skip IPMI over lanplus and use the kernel module instead.

Example: ./superfans -h bigbertha -u monkey -p secrets preset full

Options: -h, --hostname TEXT Remote hostname (default: localhost) -u, --username TEXT Remote IPMI username -p, --password TEXT Remote IPMI password -e, --env-password Use IPMI_PASSWORD environment variable for password --help Show this message and exit.

Commands: preset Applies a factory preset to fan controller. set Set fan speed to a fixed %. status Retrieves fan controller preset & fan speed.

ยฉ 2026 GitRepoTrend ยท putnam/superfans ยท Updated daily from GitHub