luchina-gabriel/osx-proxmox

★ 6,983ShellAudience · developerComplexity · 3/5Setup · moderate

Mindmap

mindmap
  root((repo))
    What it does
      Run macOS in a VM
      Automates VM setup
      No Mac needed
    Supported versions
      macOS High Sierra to Sequoia
      Proxmox VE 7 to 8.4
    Tech used
      Proxmox VE
      OpenCore bootloader
      Shell scripts
    Hardware
      AMD and Intel CPUs
      GPU passthrough
      Cloud server support

mindmap root((repo)) What it does Run macOS in a VM Automates VM setup No Mac needed Supported versions macOS High Sierra to Sequoia Proxmox VE 7 to 8.4 Tech used Proxmox VE OpenCore bootloader Shell scripts Hardware AMD and Intel CPUs GPU passthrough Cloud server support

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

Run a macOS development environment on a Windows or Linux PC without buying Apple hardware.

USE CASE 2

Test macOS apps across multiple versions using Proxmox VE snapshots.

USE CASE 3

Set up a macOS virtual machine on a rented cloud server for remote iOS development.

Tech stack

ShellProxmox VEOpenCore

Getting it running

Difficulty · moderate Time to first run · 1h+

Requires a PC already running Proxmox VE, some hardware needs BIOS tweaks or TSC compatibility fixes before macOS will boot.

In plain English

OSX-PROXMOX is a script and guide that lets you run macOS inside a virtual machine on a PC using Proxmox VE. Proxmox VE is a free, open-source platform for running virtual machines, meaning it can run multiple operating systems on one physical computer at the same time. This project automates most of the hard setup so you can get a working macOS installation on AMD or Intel hardware without owning a Mac. The setup process is intentionally short. You install a fresh copy of Proxmox VE on your computer, open the Proxmox web interface, navigate to a shell prompt, and run one command that downloads and runs the installer script. The script handles the configuration automatically. The README describes the whole thing as taking just a few steps. MacOS versions from High Sierra (10.13, released 2017) through Sequoia (15, released 2024) are all listed as supported. Proxmox VE versions 7.0 through 8.4 are confirmed working, with early support for version 9. The project uses OpenCore, an open-source bootloader that makes it possible for non-Apple hardware to load macOS. There are some hardware requirements. Machines running macOS Monterey or newer need a working TSC (timestamp counter), which is a low-level timing mechanism in the CPU. The README includes commands to check whether your machine meets this requirement and instructions to fix common issues through BIOS settings or boot parameters. GPU passthrough (connecting your graphics card directly to the virtual machine for full performance) is also covered, with specific troubleshooting steps for cases where the display gets stuck on the Apple logo. The project also notes cloud support, meaning you can theoretically run a macOS virtual machine on a rented cloud server rather than your own hardware. The README includes a disclaimer that this is intended for development, student, and testing use only.

Copy-paste prompts

Prompt 1

I'm setting up osx-proxmox to run macOS Sequoia on a PC with Proxmox VE 8 and an AMD CPU. Walk me through running the installer script and any AMD-specific OpenCore settings I need.

Prompt 2

My macOS VM on Proxmox is stuck on the Apple logo during GPU passthrough. What BIOS settings and Proxmox PCIe passthrough config should I check using the osx-proxmox guide?

Prompt 3

Using osx-proxmox, write the command to check whether my machine's TSC is compatible before I attempt to install macOS Monterey or newer.

Prompt 4

I want to run macOS Sequoia as a VM on a cloud server using Proxmox VE. What are the limitations and steps based on the osx-proxmox cloud support notes?

Open on GitHub → Explain another repo

← luchina-gabriel on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.