Professional fan speed management for HP ProLiant servers

A modern web-based application for managing fan speeds on HP ProLiant Gen8 servers with modified iLO4 firmware. Provides both an intuitive web interface and comprehensive REST API for automation and scripting.

• 🌐 Web Interface: Responsive design accessible from any device
• 🔧 Dynamic Configuration: Auto-detects and supports variable fan counts
• 🔒 Secure Authentication: Cookie-based sessions with rate limiting
• 📡 REST API: Complete API for automation and integration
• 🐳 Container Ready: Docker support with environment configuration
• ⚡ Real-time Updates: Live fan status monitoring and control

⚠️ Important: This application requires HP iLO4 firmware modified with "The Fan Hack" to enable SSH-based fan control.

Supported Hardware:

• HP ProLiant Gen8/Gen9 servers (DL360p, DL380p, etc.)
• Modified iLO4 firmware with SSH access enabled
• Network connectivity to iLO management interface

# Clone repository
git clone https://github.com/IT-Kuny/HPE-G8-G9-Fan-Controller.git
cd ilo4-fan-controller

# Build image
docker build -t ilo4-fan-controller .

# Run container
docker run -d \
  --name=HPE-G8-G9-Fan-Controller \
  --restart=unless-stopped \
  -p 3000:3000 \
  -e ILO_HOST='192.168.1.100' \
  -e ILO_USERNAME='your_ilo_username' \
  -e ILO_PASSWORD='your_ilo_password' \
  -e AUTH_USERNAME='admin' \
  -e AUTH_PASSWORD='your_secure_password' \
  -e SESSION_SECRET='your_32_char_secret_key_here' \
  HPE-G8-G9-Fan-Controller

docker run -d \
  --name=HPE-G8-G9-Fan-Controller \
  --restart=unless-stopped \
  -p 3000:3000 \
  -e ILO_HOST='192.168.1.100' \
  -e ILO_USERNAME='your_ilo_username' \
  -e ILO_PASSWORD='your_ilo_password' \
  -e AUTH_USERNAME='admin' \
  -e AUTH_PASSWORD='your_secure_password' \
  -e SESSION_SECRET='your_32_char_secret_key_here' \
  ghcr.io/it-kuny/HPE-G8-G9-Fan-Controller:latest

# Clone and setup
git clone https://github.com/IT-Kuny/HPE-G8-G9-Fan-Controller.git
cd ilo4-fan-controller

# Configure environment
cp .env.template .env
# Edit .env with your settings

# Install dependencies and build
yarn install
yarn build

# Start application
yarn start

Environment Configuration (.env):

ILO_HOST=192.168.1.100
ILO_USERNAME=your_ilo_username
ILO_PASSWORD=your_ilo_password

AUTH_USERNAME=admin
AUTH_PASSWORD=your_strong_password_here
SESSION_SECRET=random_string_at_least_32_characters_long

All API endpoints require authentication via session cookies. Obtain a session by logging in through the web interface or using the login endpoint.

Base URL: http://your-server:3000/api

BASE_URL="http://your-server:3000"

# Authenticate
curl -X POST "$BASE_URL/api/auth/login" \
  -H 'Content-Type: application/json' \
  -d '{"username":"admin","password":"your_password"}' \
  -c cookies.txt

# Unlock fan control
curl -X POST "$BASE_URL/api/fans/unlock" \
  -b cookies.txt

# Set fan speeds (percentages)
curl -X POST "$BASE_URL/api/fans" \
  -H 'Content-Type: application/json' \
  -d '{"fans":[35,35,35,35]}' \
  -b cookies.txt

# Get current status
curl "$BASE_URL/api/fans" \
  -b cookies.txt | jq .

# Logout
curl -X POST "$BASE_URL/api/auth/logout" \
  -b cookies.txt

# Cleanup
rm cookies.txt

• Session Management: Secure cookie-based authentication
• Rate Limiting: 5 login attempts per IP address per 15 minutes
• Environment Variables: All sensitive data configured via environment

• Use strong, unique passwords for AUTH_PASSWORD
• Generate cryptographically secure SESSION_SECRET (≥32 characters)
• Consider deploying behind reverse proxy with TLS termination
• For multi-instance deployments, implement shared session storage (Redis)

1. Frontend: Next.js application with server-side rendering
2. Backend: API routes handling iLO4 SSH communication
3. Dynamic Discovery: Auto-detects available fans via iLO4 queries
4. Real-time Control: Direct SSH commands for immediate fan response
5. State Management: Session-based authentication with secure cookies

• Fan speed changes typically take 10-20 seconds to apply
• Response time scales with number of fans configured
• SSH connection pooling for optimal performance

Connection Refused

• Verify iLO4 network connectivity and SSH service status
• Confirm modified firmware installation and SSH enablement

Authentication Failed

• Check iLO4 username/password in environment configuration
• Verify SSH access works manually: ssh user@ilo-ip

Fan Control Not Working

• Ensure fan control is unlocked via /api/fans/unlock
• Confirm iLO4 firmware modification supports fan speed control

Contributions are welcome! Please ensure:

• Code follows existing style conventions
• Tests pass: yarn test
• Documentation is updated for new features
• Security considerations are addressed

This project is derived from DavidIlie's ilo4-fan-controller with significant enhancements and modernizations. The fork was detached to incorporate critical improvements and maintain active development.

• ✅ User Login Interface: No more unsecured fan controls without additional effort
• ✅ Enhanced Documentation: Comprehensive setup and API guides
• ✅ Modern CI/CD: Automated testing and container builds
• ✅ Security Hardening: Rate limiting and session management
• ✅ API Expansion: Complete REST API with examples
• ✅ Production Ready: Docker support and deployment guides
• ✅ Active Maintenance: Ongoing security updates and improvements

This project maintains the same license terms as the original work. See individual source files for specific licensing information.

⚡ Built for the HomeLab Community ⚡