MacOS
MacOS runs a virtual macOS guest inside a Docker container with KVM acceleration, letting homelabbers self-host macOS desktop workloads on compatible hardware.
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.
75/100 Good
- Maintained
- 98last commit 54 days ago
- Popular
- 8721,709 GitHub stars
- Easy to install
- 351 install platform, install notes, Docker image
- Light to run
- 304 GB minimum RAM
- Security check
- 85no serious findings, CI
Availability: platform listings confirmed today, links checked 47 days ago
- GitHub stars
- 21,709
- Open issues
- 9
- Last commit
- 2026-09-28
- Latest release
- v3.12
- License
- MIT
- Activity
- stale
Checked 20 days ago - source: GitHub (dockur/macos)
Resources & Compatibility
Minimum requirements: 4 GB RAM, 12.5 GB disk. ARM (e.g. Raspberry Pi) is not supported.
Checked 54 days ago - source: Docker Hub image tags and published docs
First-install notes
- Keep /storage persistent and backed up The macOS installer image and setup files are kept in the /storage area, such as base.dmg. Mount a persistent volume there and keep backups, because losing it means downloading and reinstalling macOS again. source
- Choose macOS version before first start If the VERSION setting is blank, the app defaults to macOS 14 (Sonoma) and downloads that recovery image. Set VERSION to the macOS release you want before the first run so it downloads the right installer. source
- Leave ID fields blank to auto-generate Leave the serial, board serial, MAC address, and UUID fields empty unless you need fixed values. The app then creates valid identity values automatically, which prevents first-start problems from missing device details. source
- Enable KVM on the host The README's Docker Compose examples use /dev/kvm and NET_ADMIN for KVM acceleration; enable virtualisation in the host BIOS and grant the container access to /dev/kvm. source
Fetched 37 days ago - each note links to its source
Variants
Alternatives
No alternatives collected yet.
Common questions
Why is Docker Desktop unsupported on some systems?
Docker Desktop on Linux, macOS, and Windows 10 does not currently provide KVM access to containers, so the project marks it as unsupported.
How do I complete the first-run installation?
After starting the container, open port 8006 in a browser, format the largest Apple Inc. VirtIO Block Media disk to APFS in Disk Utility, and choose Reinstall macOS. During setup, select Not now for Migration Assistant and Set Up Later for Apple ID.
Which ports should I publish?
The example publishes 8006 for the web interface and 5900 over TCP and UDP. Expose those host ports if you need the same access.
How do I keep the macOS install persistent?
Mount a host directory to the container's /storage path, such as ./macos:/storage in Compose or a -v flag in Docker CLI.
What devices and capabilities are required for virtualization?
The container must be given /dev/kvm and /dev/net/tun, and the NET_ADMIN capability must be added. This is the setup shown in the Docker Compose and CLI examples.
Answers sourced from github.com
Community
- macOS - Apple Community (forum)
- macOS | MacRumors Forums (forum)
- macOS | MacRumors Forums (forum)
- Beginner guide/hosting on Mac/MacOS : r/selfhosted - Reddit (reddit)
- Mac - Apple Community (forum)
Collected 49 days ago - public community threads