mbpfan
mbpfan is a containerized fan-control daemon for Macs running GNU/Linux.
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
Variants
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
- Getting the mbpfan service to start at boot (Debian 12, Mac ... - Reddit (reddit)
- Is macfanctld or mbpfan still needed for Mac fan support? - Reddit (reddit)
- Can somebody help me with setting up mbpfans based on ... - Reddit (reddit)
- How to check if mbpfan is active oder not : r/linux_on_mac - Reddit (reddit)
Collected 53 days ago - public community threads