OSX-PROXMOX is a shell script automation tool that simplifies installing macOS virtual machines on Proxmox VE hypervisors running on both AMD and Intel hardware.
The tool addresses the complexity of configuring macOS guests on Proxmox by automating the setup process through a single command executed in the Proxmox shell. It handles the necessary configuration of OpenCore bootloader, EFI packages, and VM settings to enable macOS installation. The approach requires only a fresh Proxmox installation and reduces the manual steps to copying and pasting a command into the Proxmox Web Console.
Developers and system administrators running Proxmox who want to virtualize macOS should consider this tool if they need a streamlined installation path. It suits environments where users want to avoid manual OpenCore configuration and EFI setup. The tool supports Proxmox versions through the current releases and covers macOS versions from High Sierra through the latest releases. One important consideration is that the host system must have a working timestamp counter (TSC) for macOS Monterey and later, as multiple VM cores may cause crashes without it; the README provides diagnostic commands and BIOS-level fixes for systems with broken TSC implementations.
The project maintains active support across multiple Proxmox and macOS versions, with OpenCore kept current to recent releases. Documentation includes troubleshooting guidance for common issues such as recovery server connection errors and TSC-related problems, with specific BIOS configuration recommendations and kernel parameter adjustments provided for hosts experiencing compatibility issues.
