OSX-KVM: Run macOS on Linux with KVM Virtualization

Running macOS on non-Apple hardware has been a pursuit of enthusiasts and developers for years, but it has always required navigating technical complexities and legal gray areas. OSX-KVM (kholia/OSX-KVM on GitHub) provides the most comprehensive and maintained open-source toolkit for running macOS as a KVM virtual machine on Linux hosts, with near-native performance through hardware acceleration and GPU passthrough.

Created by Dhiru Kholia and maintained by a dedicated community, OSX-KVM has become the definitive resource for macOS virtualization on Linux, with over 20,000 GitHub stars. The project provides everything needed to set up a macOS virtual machine: automated scripts for creating bootable disk images, OpenCore bootloader configurations customized for KVM, performance tuning parameters, and detailed documentation for GPU passthrough and networking.

The primary use cases for OSX-KVM include iOS and macOS application development and testing without purchasing dedicated Apple hardware, CI/CD pipelines that need to build and test against macOS environments, and security research into macOS internals. For developers and teams who need macOS access but are constrained by hardware budgets, OSX-KVM provides a path to running macOS in a virtualized environment.

Virtualization Architecture

OSX-KVM’s architecture bridges Linux KVM virtualization with Apple’s macOS boot process:

graph TD
    A[Linux Host\nUbuntu / Debian / Arch] --> B[KVM\nKernel-based Virtual Machine]
    B --> C[QEMU\nVirtual Hardware Emulation]
    C --> D[OpenCore\nmacOS Boot Loader]
    D --> E[macOS Guest\nSonoma / Sequoia]
    C --> F[virtio Drivers\nStorage / Network / Input]
    C --> G[VFIO Passthrough\nGPU / USB / PCIe]
    G --> H[AMD GPU\nNative Graphics Acceleration]
    F --> I[Host Integration\nShared Clipboard / Networking]

The OpenCore bootloader is the critical component that makes macOS booting possible on non-Apple hardware. OpenCore provides the firmware-level patches and configuration that macOS expects from genuine Apple hardware, including ACPI table modifications, SMBIOS configuration, and kernel extension patching.

Hardware Compatibility Guide

Performance Considerations

Achieving good performance with OSX-KVM requires attention to several factors. CPU pinning to dedicate specific host cores to the macOS VM reduces latency. Huge pages for memory allocation improve memory access performance. The choice of storage backend matters significantly – NVMe drives with the virtio-block driver or NVMe emulation provide the best I/O performance.

GPU passthrough using VFIO is the most impactful performance decision. When a physical GPU is passed through to the macOS VM, graphics performance approaches bare-metal levels, enabling smooth UI animations, video playback, and graphics-intensive applications like Xcode’s Interface Builder. Without GPU passthrough, the VM relies on software rendering, which limits the user experience to basic operations.

Networking configuration also affects perceived performance. The choice between user-mode networking (simple but slower), bridged networking (fast but more complex), and virtio-net (best performance with the right setup) depends on the use case and network requirements.

Recommended External Resources

• OSX-KVM GitHub Repository – Scripts, configuration, and comprehensive documentation
• OpenCore Project – The bootloader that makes macOS-on-KVM possible

FAQ

What is OSX-KVM? OSX-KVM is an open-source project that provides scripts, configuration, and documentation for running macOS as a guest operating system on Linux hosts using KVM (Kernel-based Virtual Machine) virtualization. It enables near-native performance on compatible hardware by leveraging KVM’s hardware-accelerated virtualization capabilities combined with GPU passthrough.

What hardware is required for OSX-KVM? OSX-KVM requires a Linux host with a CPU that supports hardware virtualization (Intel VT-x or AMD-V). For GPU acceleration, a compatible AMD or Intel integrated GPU is recommended. NVIDIA GPUs have limited support in recent macOS versions. The host should have sufficient RAM (16GB+ recommended), storage space for the macOS image, and ideally a supported Wi-Fi card if network features are needed.

Is OSX-KVM legal? OSX-KVM’s legality depends on compliance with Apple’s macOS End User License Agreement (EULA). Apple’s EULA generally permits running macOS as a guest on Apple hardware but restricts it on non-Apple hardware. OSX-KVM provides the tools; users are responsible for understanding and complying with Apple’s licensing terms in their jurisdiction.

What macOS versions does OSX-KVM support? OSX-KVM supports a wide range of macOS versions, from older releases like High Sierra (10.13) to the latest versions including macOS Sonoma and macOS Sequoia. The project maintains configuration templates for each supported version and provides guidance on the specific patches and settings required for each release.

Can GPU passthrough work with OSX-KVM? Yes, GPU passthrough is one of OSX-KVM’s most requested features and is supported with compatible hardware. VFIO passthrough of AMD GPUs works well, providing near-native graphics performance for macOS guests. Intel integrated GPU passthrough is also supported but requires additional configuration. NVIDIA GPU support is limited due to macOS driver availability.

Further Reading

• OSX-KVM on GitHub – Repository with scripts, configuration, and guides
• OpenCore Bootloader – The underlying bootloader project enabling macOS virtualization