Skip to content
<awesome-gh-repos>
vic

luchina-gabriel/OSX-PROXMOX

Voilà, install macOS on ANY Computer! This is really and magic easiest way! PVE 7.XX ~ 8.XX Support and macOS High Sierra ~ macOS Sequoia Support.
Source code at GitHub https://osx-proxmox.com
luchina-gabriel/OSX-PROXMOX.json
{
  "createdAt": "2021-11-03T02:42:26Z",
  "defaultBranch": "main",
  "description": "Voilà, install macOS on ANY Computer! This is really and magic easiest way! PVE 7.XX ~ 8.XX Support and macOS High Sierra ~ macOS Sequoia Support.",
  "fullName": "luchina-gabriel/OSX-PROXMOX",
  "homepage": "https://osx-proxmox.com",
  "language": "Shell",
  "name": "OSX-PROXMOX",
  "pushedAt": "2025-11-05T14:32:12Z",
  "stargazersCount": 5688,
  "topics": [
    "apple",
    "hackintosh",
    "macos",
    "opencore",
    "proxmox",
    "virtualization"
  ],
  "updatedAt": "2025-11-27T06:42:46Z",
  "url": "https://github.com/luchina-gabriel/OSX-PROXMOX"
}

🚀 OSX-PROXMOX - Run macOS on ANY Computer (AMD & Intel)

Section titled “🚀 OSX-PROXMOX - Run macOS on ANY Computer (AMD & Intel)”

GitHub stars GitHub forks GitHub license GitHub issues

v15 - Sequoia Easily install macOS on Proxmox VE with just a few steps! This guide provides the simplest and most effective way to set up macOS on Proxmox, whether you’re using AMD or Intel hardware.

🛠 Installation Guide

Section titled “🛠 Installation Guide”
  1. Install a FRESH/CLEAN version of Proxmox VE (v7.0.XX ~ 8.4.XX) - just follow the Next, Next & Finish (NNF) approach.
    • Preliminary support for Proxmox VE V9.0.0 BETA.
  2. Open the Proxmox Web Console → Navigate to Datacenter > YOUR_HOST_NAME > Shell.
  3. Copy, paste, and execute the command below:
Terminal window
/bin/bash -c "$(curl -fsSL https://install.osx-proxmox.com)"

🎉 Voilà! You can now install macOS! osx-terminal

Section titled “🎉 Voilà! You can now install macOS! ”

🔧 Additional Configuration

Section titled “🔧 Additional Configuration”

Install EFI Package in macOS (Disable Gatekeeper First)

Section titled “Install EFI Package in macOS (Disable Gatekeeper First)”
Terminal window
sudo spctl --master-disable

🍏 macOS Versions Supported

Section titled “🍏 macOS Versions Supported”

✅ macOS High Sierra - 10.13
✅ macOS Mojave - 10.14
✅ macOS Catalina - 10.15
✅ macOS Big Sur - 11
✅ macOS Monterey - 12
✅ macOS Ventura - 13
✅ macOS Sonoma - 14
✅ macOS Sequoia - 15

🖥 Proxmox VE Versions Supported

Section titled “🖥 Proxmox VE Versions Supported”

✅ v7.0.XX ~ 8.4.XX

🔄 OpenCore Version

Section titled “🔄 OpenCore Version”
  • April/2025 - 1.0.4 → with SIP Enabled, DMG only signed by Apple and all features of securities

☁️ Cloud Support (Run Hackintosh in the Cloud!)

Section titled “☁️ Cloud Support (Run Hackintosh in the Cloud!)”
  • 🌍 VultR
  • 📺 Video Tutorial (Enable captions for better understanding)
  • Now has configurable bridges, and can add as many bridges and specify the subnet for them.

⚠️ Disclaimer

Section titled “⚠️ Disclaimer”

🚨 FOR DEVELOPMENT, STUDENT, AND TESTING PURPOSES ONLY.

I am not responsible for any issues, damage, or data loss. Always back up your system before making any changes.

📌 Requirements

Section titled “📌 Requirements”

Since macOS Monterey, your host must have a working TSC (timestamp counter). Otherwise, if you assign multiple cores to the VM, macOS may crash due to time inconsistencies. To check if your host is compatible, run the following command in Proxmox:

Terminal window
dmesg | grep -i -e tsc -e clocksource

✅ Expected Output (for working hosts):

Section titled “✅ Expected Output (for working hosts):”
clocksource: Switched to clocksource tsc

❌ Problematic Output (for broken hosts):

Section titled “❌ Problematic Output (for broken hosts):”
tsc: Marking TSC unstable due to check_tsc_sync_source failed
clocksource: Switched to clocksource hpet

🛠 Possible Fixes

Section titled “🛠 Possible Fixes”
  1. Disable “ErP mode” and all C-state power-saving modes in your BIOS. Then power off your machine completely and restart.
  2. Try forcing TSC in GRUB:
    • Edit /etc/default/grub and add:
      Terminal window
      clocksource=tsc tsc=reliable
    • Run update-grub and reboot (This may cause instability).
  3. Verify the TSC clock source:
    Terminal window
    cat /sys/devices/system/clocksource/clocksource0/current_clocksource
    The output must be tsc.

Read More

🔍 Troubleshooting

Section titled “🔍 Troubleshooting”

❌ High Sierra & Below - Recovery Server Could Not Be Contacted

Section titled “❌ High Sierra & Below - Recovery Server Could Not Be Contacted”

If you encounter this error, you need to switch from HTTPS to HTTP in the installation URL:

  1. When the error appears, leave the window open.

  2. Open Installer Log (Window > Installer Log).

  3. Search for “Failed to load catalog” → Copy the log entry.

  4. Close the error message and return to macOS Utilities.

  5. Open Terminal, paste the copied data, and remove everything except the URL (e.g., https://example.sucatalog).

  6. Change https:// to http://.

  7. Run the command:

    Terminal window
    nvram IASUCatalogURL="http://your-http-url.sucatalog"

  8. Quit Terminal and restart the installation.

Reference & More Details

❌ Problem for GPU Passthrough

Section titled “❌ Problem for GPU Passthrough”

If you see an Apple logo and the bar doesn’t move on your external display, you need to disable “above 4g decoding” in the motherboard’s BIOS.

In some environments it is necessary to segment the IOMMU Groups to be able to pass the GPU to the VM.

  1. Add the content pcie_acs_override=downstream,multifunction pci=nommconf in the file /etc/default/grub at the end of the line GRUB_CMDLINE_LINUX_DEFAULT;
  2. After changing the grub file, run the command update-grub and reboot your PVE.

🎥 Demonstration (in Portuguese)

Section titled “🎥 Demonstration (in Portuguese)”

📽️ Watch on YouTube
(Enable auto-translate captions for English subtitles!)

🎖 Credits

Section titled “🎖 Credits”
  • OpenCore/Acidanthera Team - Open-source bootloader
  • Corpnewt - Tools (ProperTree, GenSMBIOS, etc.)
  • Apple - macOS
  • Proxmox - Fantastic virtualization platform & documentation

🌎 Join Our Community - Universo Hackintosh Discord

Section titled “🌎 Join Our Community - Universo Hackintosh Discord”

💬 Join Here!