selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

OpenFan Controller logo

Self-host OpenFan Controller

2026-10-09

Open-hardware PC fan controller with web GUI and API

ReleaseOpen SourceGPL-3.0
Updated9 months ago
LanguageCSS
Setup difficultyModerate
Stars
321
Port
3000 (HTTP API and web GUI)
Docker
ghcr.io/sasakaranovic/openfancontroller
Install with Docker

What is OpenFan Controller?

OpenFanController is an open-source, open-hardware project for controlling up to 10 PC fans individually via a custom PCB (available assembled or as a DIY build). The software component is a Python-based server that communicates with the hardware over USB and exposes both a web-based GUI and a REST API on port 3000. Users can set fan speeds by PWM percentage or target RPM, create unlimited custom fan profiles, and apply them via the GUI or API. The server can be deployed as a Docker container (ghcr.io/sasakaranovic/openfancontroller:release) and runs on Windows, Linux, and macOS. Integrations include a FanControl plugin for Windows and an Unraid Community Application. The API has no built-in authentication or encryption, so firewall restrictions are recommended for remote access. The project is licensed under GPL-3.0 and actively maintained with firmware releases in 2026.

Should you self-host OpenFan Controller?

OpenFan Controller scores 50/100 on selfhost.directory (how scoring works) and ranks #63 of 104 in Home Automation. It has 321 GitHub stars.

It shipped 3 stable releases in the past year. The latest, 2026-10-09, came out on 9 October 2026. New versions land roughly every 2 weeks.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is GPL-3.0-licensed and written mostly in CSS.

Its closest alternative on selfhost.directory is Home Assistant (91/100, 91 794 stars). It scores higher overall, so compare the two before you pick. See OpenFan Controller vs Home Assistant side by side.

Features

  • Cross-platform
  • Custom Fan Profiles
  • FanControl integrationWindows only
  • Individual fan control
  • REST APINo authentication or encryption; secure via firewall
  • Unraid integration
  • USB bootloader
  • Web GUI

OpenFan Controller README

How to install OpenFan Controller

Install OpenFan Controller with Docker

docker pull ghcr.io/sasakaranovic/openfancontroller:release

Runs the GUI/API server on port 3000; requires OpenFAN hardware connected via USB

How to configure OpenFan Controller

  • config.yamlMain configuration file for the OpenFAN server, stores port setting and fan profiles

    Main configuration file for the OpenFAN server, stores port setting and fan profiles

  • port3000Port for the API server and web GUI (default 3000)

    Port for the API server and web GUI (default 3000)

OpenFan Controller releases & version history

More in Home Server

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…