# mbpfan

mbpfan is a containerized fan-control daemon for Macs running GNU/Linux. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2279/mbpfan

## Description

mbpfan is a containerized fan-control daemon for Macs running GNU/Linux. It reads processor temperatures from the coretemp kernel module and drives fan speeds through the applesmc module, giving automatic active cooling to anyone running Linux on Mac hardware who needs their fans properly managed.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

65/100 (Good), based on 4 of 5 factors.
- Maintained: 72 (last commit 13 days ago)
- Popular: 61 (1,075 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Security check: 85 (no serious findings, tests)

## Links

- Docker Hub: https://hub.docker.com/r/bplein/mbpfan
- Official website: https://ineed.coffee/projects/mbpfan
- GitHub: https://github.com/linux-on-mac/mbpfan
- Unraid: https://ca.unraid.net/apps/mbpfan-03mbfqv1cplto3?q=mbpfan

## Common questions

### What should I do if the Mac sensor modules are not loaded?

Check with lsmod | grep -e applesmc -e coretemp. If either is missing, add applesmc and coretemp to /etc/modules so they load at boot, because mbpfan cannot read Mac sensors or control fans without them.

### How can I install mbpfan without building it from source?

Use your distribution's package manager, for example apt on Debian/Ubuntu or dnf on Fedora. This provides the correct system files and avoids the extra work of building it from source.

### How do I install the Debian init file when setting up mbpfan from source?

Rename mbpfan.init.debian to mbpfan, give it execution permissions, and move it to /etc/init.d. Then add it to the default runlevels as root.

### What has happened to users who set MBPFan values but the fans stay at minimum RPM?

One report described an iMac with GPU issues where the fans remained at the lowest RPM constantly even after the correct values were set in mbpfan.conf.

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