Our take
- Activity
- 72
- Community
- 33
- Issues
- 56
- Pull requests
- 83
+94 stars in the last 30 days
- Merges more pull requests than 94% of the projects we track
- Releases more often than 77% of the projects we track
Project history
Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.
Stars
21,751Forks
1,147Change since Nov 16, 2026: +5 stars·0 forks
Overview
dockur/macos runs macOS as a virtual machine managed from a Docker container. It automates downloading the recovery image and preparing the installation, while exposing the VM through a browser-based viewer and optional VNC.
It can suit developers and homelab users who need a macOS environment on supported hardware without managing a VM setup manually. The project does not distribute macOS, and its README says to run it only on Apple hardware under Apple's terms.
Key Features
- Automatic macOS recovery download and guided installation.
- KVM acceleration for near-native performance on compatible hosts.
- Configurable CPU cores, RAM, and virtual disk capacity.
- Optional GPU acceleration through Reims vGPU.
- USB and disk-device passthrough, plus host-folder sharing.
- Networking options including NAT, macvlan, and DHCP modes.
- Browser-based access through the web viewer, with optional audio streaming.
Use Cases
- Developers can keep a macOS test environment in a container-managed setup when their host supports KVM.
- Homelab operators can run a macOS VM alongside other containerized services.
- Users can test macOS versions from the options documented by the project without setting up the VM entirely by hand.
- Teams or individuals can configure CPU, memory, storage, networking, and device access for a dedicated macOS environment.
Getting Started
The README provides Docker Compose, Docker CLI, and Kubernetes examples. A minimal Compose setup is:
services:
macos:
image: dockurr/macos
environment:
VERSION: "15"
devices:
- /dev/kvm
- /dev/net/tun
cap_add:
- NET_ADMIN
ports:
- 8006:8006
volumes:
- ./macos:/storage
Start the service, then open http://127.0.0.1:8006/ to continue installation. See the README for full configuration and installation instructions.
Considerations
- The host must provide KVM support. The README lists Linux hosts and Windows 11 with nested virtualization as supported setups, and says Docker Desktop on Linux, macOS, and Windows 10 does not provide the required KVM access.
- Requirements include an AVX2-capable processor, at least 4 GB of available RAM, and 32 GB of free disk space.
- macOS installation requires user interaction after the recovery image is downloaded.
- The project does not include macOS itself. Its README states that Apple's license terms restrict use to Apple hardware; users are responsible for complying with those terms.
Found this useful?
Share it with someone who would like macos.