MacOS

MacOS runs a virtual macOS guest inside a Docker container with KVM acceleration, letting homelabbers self-host macOS desktop workloads on compatible hardware.

  • Infrastructure
  • Network Services
  • Other
  • Productivity
  • Tools & Utilities
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

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

Collected 49 days ago - public community threads