mbpfan

mbpfan is a containerized fan-control daemon for Macs running GNU/Linux.

  • Tools & Utilities
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
  • TrueNAS (not listed)
  • Umbrel (not listed)
  • ZimaOS (not listed)
  • Proxmox (not listed)
  • Helm (not listed)
  • Mac (not listed)
  • Windows (not listed)
  • Linux (not listed)
  • Any server (not listed)

Health score?A 0-100 score computed nightly from four factors: maintained (40%: recent commits and steady activity), popular (25%: GitHub stars, log scale), easy to install (20%: platforms, install notes, setup guides, Docker image) and light to run (15%: minimum RAM, ARM support). When the source code has been checked, a fifth factor, security check (20%: automated scan for committed secrets, unsafe desktop-app settings, known-vulnerable dependencies and project hygiene; any serious finding caps it at 20), is added. Factors without data are left out and the rest are rescaled.

65/100 Good

Maintained
72last commit 13 days ago
Popular
611,075 GitHub stars
Easy to install
351 install platform, install notes, Docker image
Light to run
No data
Security check
85no serious findings, tests

Based on 4 of 5 factors.

Availability: platform listings confirmed today, links checked 29 days ago

GitHub stars
1,075
Open issues
25
Last commit
2026-11-08
Latest release
v2.4.0
License
GPL-3.0
Activity
rising

Checked 9 days ago - source: GitHub (linux-on-mac/mbpfan)

Resources & Compatibility

ARM (e.g. Raspberry Pi) is not supported.

Checked 54 days ago - source: Docker Hub image tags and published docs

First-install notes

  • Check the Mac sensor modules are loaded Check that the Mac sensor drivers (Linux kernel modules) are loaded by running: lsmod | grep -e applesmc -e coretemp. If either is missing, add applesmc and coretemp to /etc/modules so they load at boot; without these drivers mbpfan cannot read Mac sensors or control the fans. source
  • Install mbpfan with your distro's package manager Use your Linux distribution's package manager (for example apt on Debian/Ubuntu or dnf on Fedora) to install mbpfan. That gives you the correct system files and avoids the extra work of building it from source. source
  • Start and enable the mbpfan service After installing, make sure the mbpfan service is enabled and running so it starts at boot, often with your system's service manager (systemctl enable mbpfan and systemctl start mbpfan). If it is not running, your Mac's fans will not be managed, which can cause overheating or noisy fans. source
  • Container config file Create an mbpfan.conf (an example for a Late 2012 i7 Mac mini is in the bplein/mbpfan repo) and mount it into the container at /etc/mbpfan.conf. source

Fetched 39 days ago - each note links to its source

Alternatives

No alternatives collected yet.

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.

Answers sourced from github.com, www.reddit.com, www.reddit.com

Community

Collected 53 days ago - public community threads