The macos-simple-kvm repository provides tools and scripts to set up a macOS virtual machine in QEMU with KVM acceleration on Linux systems. Created by FoxletFox with contributions from the community, the project eliminates the need for a physical Mac to run macOS, instead enabling users to virtualize multiple macOS versions on Linux hardware with KVM support.
The repository is written primarily in Shell and supports multiple macOS versions including High Sierra, Mojave, Catalina, and Big Sur. The core workflow involves three main steps: downloading macOS installation media using the jumpstart.sh script, creating a virtual hard disk with qemu-img and configuring it in basic.sh, and then running the virtual machine. The project includes specialized scripts for different deployment scenarios, such as headless.sh for cloud-based or headless systems that require VNC support for remote access.
Key features documented in the repository include performance tuning guides covering memory allocation, bridged networking configuration, GPU passthrough for hardware acceleration, screen resolution adjustments, and sound feature enablement. The project also supports integration with Virtual Machine Manager through the make.sh script, allowing users to import their QEMU setup into virt-manager for additional configuration options. For headless deployments, the repository provides VNC support with configurable settings and default port 5900 access.
The repository addresses a specific technical niche within the virtualization community. GitGenius classification data indicates the project spans multiple domains including hypervisor setup, QEMU and libvirt management, ARM and Apple Silicon emulation, and cross-platform Linux compatibility. The project has attracted contributors with overlapping involvement in major repositories including microsoft/vscode, microsoft/typescript, and rust-lang/rust, suggesting it serves developers and technical users who work across multiple ecosystems.
Community engagement metrics show moderate but inconsistent activity patterns. Across 42 tracked issues and pull requests, the median response latency is 430 hours while the mean extends to 9574.7 hours, indicating variable response times with occasional longer delays. The most active contributors tracked by GitGenius include notAperson535 with 6 events, rehmm070304 with 5 events, and unfamiliardev with 5 events, representing a small core of engaged maintainers and contributors.
The project includes comprehensive documentation through FAQs and specialized guides, addressing common questions for users new to macOS virtualization and KVM. The repository supports various Linux distributions with requirements for QEMU 3.1 or later, Python 3, pip, and enabled KVM kernel modules. The project accepts donations through Coinbase and PayPal, indicating ongoing maintenance and development efforts. The combination of straightforward setup scripts, detailed performance guides, and support for multiple macOS versions makes the repository a practical resource for developers and system administrators seeking to run macOS virtual machines on Linux infrastructure.
