The kholia/osx-kvm repository provides a comprehensive solution for running macOS as a virtual machine on Linux systems using QEMU/KVM virtualization. Its primary purpose is to enable users to create a "Virtual Hackintosh" environment without requiring a physical Mac, thereby facilitating macOS-based educational tasks, software builds, testing, kernel debugging, security research, and general interoperability experiments. The project supports recent macOS versions, including Monterey, Ventura, and Sonoma, and leverages OpenCore for boot management, ensuring compatibility and flexibility.
The repository is designed for users with modern Linux distributions (such as Ubuntu 24.04 LTS or later) and requires QEMU version 8.2.2 or higher. It mandates CPUs with virtualization extensions (Intel VT-x or AMD SVM), SSE4.1 for macOS Sierra and later, and AVX2 for Ventura and above. While older AMD CPUs may pose challenges, modern AMD Ryzen processors are confirmed to work well, even with the latest macOS releases.
Installation is straightforward and well-documented. Users are guided through installing necessary packages, cloning the repository, configuring KVM, and preparing their system for virtualization. The process includes fetching the desired macOS installer using a provided script, converting installation images, and creating a virtual hard disk. The main installation is initiated via the OpenCore-Boot.sh script, which works across supported macOS versions. Additional instructions are provided for integrating with libvirt tools (virt-manager or virsh), allowing for more advanced VM management and configuration.
The repository also supports headless macOS operation, enabling users to run macOS VMs without a graphical interface, which is particularly useful for build farms or automated testing environments. There are scripts and notes for setting up networking, device passthrough (such as GPUs), resolution changes, and troubleshooting common issues like iMessage functionality. Users are encouraged to consult included notes for optimizing their macOS VM and addressing limitations such as lack of graphical acceleration, reliable sound, and USB 3 support. The project invites contributions, especially in areas like documentation for cloud deployments, kernel debugging, build farm automation, and robustness improvements.
Legal considerations are addressed in detail. The repository includes the Apple OSK string, which is publicly available and referenced in court documents. Users are advised to review the legality of running macOS on non-Apple hardware, referencing guides and articles for further information. The project emphasizes personal responsibility regarding Apple’s EULA and clarifies that it does not offer legal advice.
Commercial support is available for users seeking assistance, with sponsors gaining access to a private repository and direct help. The repository’s motivation is rooted in providing an accessible, reproducible macOS environment for research and development, without deep dependence on Apple’s ecosystem. The maintainer shares personal experiences and the broader context of Hackintosh development, highlighting the project’s utility for those needing macOS functionality on Linux systems. Overall, kholia/osx-kvm stands out as a robust, well-supported resource for virtualizing macOS, catering to a wide range of technical and research needs.
