# OpenFAN-Service

OpenFAN-Service is a self-hosted home automation app. Automatic fan control for the OpenFAN controller. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/7792/openfan-service

## Description

Automatic fan control for the OpenFAN controller. Create fan curves in a web UI, drive them from Unraid disk temperatures (or CPU, scripts, other sources), with fail-safe to 100% and notifications if anything goes wrong.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

44/100 (Fair), based on 3 of 4 factors.
- Maintained: 75 (last commit 4 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/app_3a6d47144ea15d9e
- GitHub: https://github.com/SasaKaranovic/OpenFan-Service

## Common questions

### Which host mounts and port should I map for an Unraid Docker install?

Map /config to /mnt/user/appdata/openfan-service, /unraid read-only to /var/local/emhttp for Unraid disk info, and /dev/ttyACM0 for the controller. The web UI uses port 5340.

### Does the service control fans that are not assigned to a curve?

No, only fans assigned to a curve are controlled. Unmanaged fans are never touched by the service.

### How should a spun-down Unraid disk be treated by an Unraid disks sensor source?

Unraid reports spun-down disks as *. You can make that value 0 °C, ignore it, or treat it as a fault that triggers fail-safe.

### What settings are needed for TrueNAS SCALE?

Store /config on a dataset, set PUID and PGID to 568, and use the Linux hwmon sensor source.

### Can I run this service before I have the OpenFAN hardware?

Yes, the repository examples include a simulated demo compose file that starts the service with a simulated controller and sensors.

### Can it run alongside the existing OpenFAN Controller container?

Yes, OpenFAN Service can run stand-alone or in parallel to the existing OpenFAN Controller docker container.

---
Source: Our Local Host (https://ourlocalhost.com/app/7792/openfan-service), the self-hosted and open-source app directory.
