IPMI Fan Control

A modern web-based application for controlling fan speeds on Dell T710 and compatible servers using IPMI. Features a clean web UI, automatic fan curves, panic mode for safety, and support for multiple servers.

Features

• 🖥️ Multiple Server Support - Manage multiple servers from a single interface
• 🌡️ Temperature-Based Fan Curves - Automatically adjust fan speeds based on CPU temperatures
• ⚡ Panic Mode - Automatically sets fans to 100% if sensor data is lost
• 🎛️ Manual Fan Control - Direct control over individual fans or all fans at once
• 📊 Real-time Monitoring - View temperatures, fan speeds, and power consumption
• 🔒 Secure Authentication - JWT-based authentication with encrypted passwords
• 🐳 Docker Support - Easy deployment with Docker Compose
• 🔄 Persistent Storage - Settings and credentials survive container restarts

Supported Servers

• Dell PowerEdge T710 (tested)
• Dell PowerEdge R710/R720/R730 (should work)
• Dell PowerEdge R810/R820/R910/R920 (should work)
• HPE servers with iLO (partial support)

Quick Start

Prerequisites

• Docker and Docker Compose installed
• IPMI enabled on your server(s) with network access

Installation

1. Clone the repository:

git clone https://git.lemonlink.eu/impulsivefps/ipmi-fan-control.git
cd ipmi-fan-control

2. Copy the example environment file and edit it:

cp .env.example .env
# Edit .env and set a secure SECRET_KEY

3. Create the data directory:

mkdir -p data

4. Start the application:

docker-compose up -d

5. Access the web interface at http://your-server-ip:8000

6. Complete the setup wizard to create your admin account

First Time Setup

1. When you first access the web UI, you'll be guided through a setup wizard
2. Create an administrator account
3. Add your first server by providing:
   • Server name
   • IP address/hostname
   • IPMI username and password
   • Vendor (Dell, HPE, etc.)

Usage

Manual Fan Control

1. Go to a server's detail page
2. Click on the "Fan Control" tab
3. Enable "Manual Fan Control"
4. Use the slider to set the desired fan speed
5. Click "Apply" to send the command

Automatic Fan Curves

1. Go to the "Fan Curves" page for your server
2. Create a new fan curve with temperature/speed points
3. Select the curve and click "Start Auto Control"
4. The system will automatically adjust fan speeds based on temperatures

Panic Mode

Panic mode is enabled by default. If the application loses connection to a server and cannot retrieve sensor data for the configured timeout period (default: 60 seconds), it will automatically set all fans to 100% speed for safety.

IPMI Commands Used

This application uses the following IPMI raw commands:

Dell Servers

• Enable Manual Control: raw 0x30 0x30 0x01 0x00
• Disable Manual Control: raw 0x30 0x30 0x01 0x01
• Set Fan Speed: raw 0x30 0x30 0x02 <fan_id> <speed_hex>
• Get 3rd Party PCIe Status: raw 0x30 0xce 0x01 0x16 0x05 0x00 0x00 0x00
• Enable 3rd Party PCIe Response: raw 0x30 0xce 0x00 0x16 0x05 0x00 0x00 0x00 0x05 0x00 0x00 0x00 0x00
• Disable 3rd Party PCIe Response: raw 0x30 0xce 0x00 0x16 0x05 0x00 0x00 0x00 0x05 0x00 0x01 0x00 0x00

Standard IPMI

• Get Temperatures: sdr type temperature
• Get All Sensors: sdr elist full
• Get Power Supply Status: sdr type 'Power Supply'
• Dell Power Monitor: delloem powermonitor

Fan Mapping

For Dell servers, the fan mapping is:

IPMI ID	Physical Fan
0x00	Fan 1
0x01	Fan 2
0x02	Fan 3
0x03	Fan 4
0x04	Fan 5
0x05	Fan 6
0x06	Fan 7
0xff	All Fans

Configuration

Environment Variables

Variable	Default	Description
SECRET_KEY	(required)	Secret key for JWT tokens
DATA_DIR	/app/data	Directory for persistent data
PANIC_TIMEOUT_SECONDS	60	Seconds before panic mode activates
PANIC_FAN_SPEED	100	Fan speed during panic mode (%)
DATABASE_URL	sqlite:///app/data/...	Database connection string
DEBUG	false	Enable debug mode

Docker Compose

version: '3.8'

services:
  ipmi-fan-control:
    image: ipmi-fan-control:latest
    container_name: ipmi-fan-control
    restart: unless-stopped
    ports:
      - "8000:8000"
    environment:
      - SECRET_KEY=your-secure-secret-key
      - PANIC_TIMEOUT_SECONDS=60
    volumes:
      - ./data:/app/data

Building from Source

Backend

cd backend
pip install -r requirements.txt
python -m uvicorn main:app --reload

Frontend

cd frontend
npm install
npm run dev

Development

The application consists of:

• Backend: Python FastAPI with SQLAlchemy ORM
• Frontend: React with TypeScript, Material-UI, and Recharts
• Database: SQLite (default) or PostgreSQL
• IPMI: Direct integration with ipmitool

Security Considerations

1. Change the default SECRET_KEY in production
2. Use HTTPS when accessing over the internet
3. Place behind a reverse proxy (nginx, traefik) for SSL termination
4. Use strong passwords for the admin account
5. Server passwords are encrypted at rest using Fernet encryption
6. Regularly update the Docker image for security patches

Troubleshooting

Cannot connect to server

1. Verify IPMI is enabled in the server's BIOS/iDRAC settings
2. Check network connectivity: ping <server-ip>
3. Test IPMI manually: ipmitool -I lanplus -H <ip> -U <user> -P <pass> mc info
4. Check firewall rules allow IPMI traffic (port 623)

Fan control not working

1. Ensure manual fan control is enabled first
2. Check that the server supports the IPMI raw commands
3. Verify you have admin/root IPMI privileges
4. Some servers require 3rd party PCIe card response to be disabled

Container won't start

1. Check logs: docker-compose logs -f
2. Verify data directory has correct permissions
3. Ensure port 8000 is not already in use

License

MIT License - See LICENSE file for details

Contributing

Contributions are welcome! Please:

1. Fork the repository
2. Create a feature branch
3. Make your changes
4. Submit a pull request

Support

For issues and feature requests, please use the GitHub issue tracker.

Acknowledgments

• Dell for the IPMI command documentation
• The ipmitool project
• FastAPI and React communities