OSX-PROXMOX

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

1. Install a FRESH/CLEAN version of Proxmox VE (v7.X.XX ~ 9.X.XX) - just follow the Next, Next & Finish (NNF) approach.
2. Open the Proxmox Web Console → Navigate to Datacenter > YOUR_HOST_NAME > Shell.
3. Copy, paste, and execute the command below:

/bin/bash -c "$(curl -fsSL https://install.osx-proxmox.com)"

🎉 Voilà! You can now install macOS!

⚠️ This screen is NORMAL after install of osx-proxmox

🔧 Additional Configuration

Install EFI Package in macOS (Disable Gatekeeper First)

sudo spctl --master-disable

---

🍏 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
✅ macOS Tahoe - 26

---

🖥 Proxmox VE Versions Supported

✅ v7.XX.XX ~ 9.XX.XX

🔄 OpenCore Version

• September/2026 - 1.0.8 → with SIP Enabled, DMG only signed by Apple and all features of securities

---

☁️ 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

🚨 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

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:

dmesg | grep -i -e tsc -e clocksource

✅ Expected Output (for working hosts):

clocksource: Switched to clocksource tsc

❌ Problematic Output (for broken hosts):

tsc: Marking TSC unstable due to check_tsc_sync_source failed
clocksource: Switched to clocksource hpet

🛠 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:

     clocksource=tsc tsc=reliable
     

   • Run update-grub and reboot (This may cause instability).
3. Verify the TSC clock source:

   cat /sys/devices/system/clocksource/clocksource0/current_clocksource
   

   The output must be tsc.

Read More

---

🔍 Troubleshooting

❌ 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:

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

8. Quit Terminal and restart the installation.

Reference & More Details

❌ macOS Tahoe - Cursor Freeze

On macOS 26, the cursor may randomly freeze when using a USB tablet. VMs created by the setup for Tahoe already use virtio-tablet-pci (with Use tablet for pointer disabled in the VM’s Options tab).

For Tahoe VMs created with an older version of the setup, disable Use tablet for pointer in the VM’s Options tab, then run this in the Proxmox shell:

clear; read -p "Enter your macOS VM ID number: " VMID; \
ARGS="$(qm config $VMID | grep ^args: | cut -d' ' -f2-)"; \
ARGS="${ARGS/ -device usb-tablet/}"; \
qm set $VMID -args "$ARGS -device virtio-tablet-pci"

Note: With virtio-tablet-pci, middle-click acts as right-click in the VM.

❌ 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. Some environments, add de content pcie_port_pm=off in the file /etc/default/grub at the end of the line GRUB_CMDLINE_LINUX_DEFAULT;
3. After changing the grub file, run the command update-grub and reboot your PVE.

Some environments, you need create a /etc/modprobe.d/vfio-pci.conf with content: options vfio-pci ids=XXXX:XXXX,XXXX:XXXX disable_vga=on

More Information of Passthrough Proxmox Docs

---

🎥 Demonstration (in Portuguese)

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

---

🎖 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

💬 Join Here!