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.
- Install a FRESH/CLEAN version of Proxmox VE (v7.0.XX ~ 8.4.XX) - just follow the Next, Next & Finish (NNF) approach.
- Open the Proxmox Web Console → Navigate to
Datacenter > YOUR_HOST_NAME > Shell
. - Copy, paste, and execute the command below:
/bin/bash -c "$(curl -fsSL https://install.osx-proxmox.com)"
sudo spctl --master-disable
✅ 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
✅ v7.0.XX ~ 8.4.XX
- April/2025 - 1.0.4 → with SIP Enabled, DMG only signed by Apple and all features of securities
- 🌍 VultR
- 📺 Video Tutorial (Enable captions for better understanding)
🚨 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.
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
clocksource: Switched to clocksource tsc
tsc: Marking TSC unstable due to check_tsc_sync_source failed
clocksource: Switched to clocksource hpet
- Disable "ErP mode" and all C-state power-saving modes in your BIOS. Then power off your machine completely and restart.
- Try forcing TSC in GRUB:
- Edit
/etc/default/grub
and add:clocksource=tsc tsc=reliable
- Run
update-grub
and reboot (This may cause instability).
- Edit
- Verify the TSC clock source:
The output must be
cat /sys/devices/system/clocksource/clocksource0/current_clocksource
tsc
.
If you encounter this error, you need to switch from HTTPS to HTTP in the installation URL:
-
When the error appears, leave the window open.
-
Open Installer Log (
Window > Installer Log
). -
Search for "Failed to load catalog" → Copy the log entry.
-
Close the error message and return to
macOS Utilities
. -
Open Terminal, paste the copied data, and remove everything except the URL (e.g.,
https://example.sucatalog
). -
Change
https://
tohttp://
. -
Run the command:
nvram IASUCatalogURL="http://your-http-url.sucatalog"
-
Quit Terminal and restart the installation.
In some environments it is necessary to segment the IOMMU Groups to be able to pass the GPU to the VM.
- Add the content
pcie_acs_override=downstream,multifunction pci=nommconf
in the file/etc/default/grub
at the end of the lineGRUB_CMDLINE_LINUX_DEFAULT
; - After changing the grub file, run the command
update-grub
and reboot your PVE.
📽️ Watch on YouTube
(Enable auto-translate captions for English subtitles!)
- OpenCore/Acidanthera Team - Open-source bootloader
- Corpnewt - Tools (ProperTree, GenSMBIOS, etc.)
- Apple - macOS
- Proxmox - Fantastic virtualization platform & documentation