Requirements

Before installing OSX Proxmox Next, verify your hardware and software meet the following requirements.

Hardware

Component	Minimum	Recommended
CPU	2 cores (power of 2), VT-x or AMD-V	8+ cores
RAM	8 GB host (4 GB allocated to VM)	16+ GB host
Storage	64 GB minimum (defaults: 80-160 GB by version)	128+ GB SSD/NVMe
GPU	Integrated	Discrete (for passthrough)

note

CPU core count must be a power of 2 (2, 4, 8, 16). Non-power-of-2 values like 6 or 12 can cause the macOS kernel to hang at the Apple logo.

CPU Type	How It Works
Intel (Skylake+)	Native host passthrough -- best performance
Intel Xeon	Native host passthrough with `e1000` NIC (vmxnet3 unsupported on most Xeon hosts)
Intel (pre-Skylake)	Penryn mode with `e1000` NIC for install stability
AMD	Cascadelake-Server emulation -- functional but slower

All CPU types are auto-detected. No manual configuration needed.

Requirement	Details
Proxmox VE	Version 9 with root shell access
Python	3.9+ (only for pipx/pip install method)
dmg2img	Installed automatically by the tool
Internet	Required for bootstrap and downloading macOS recovery images

The tool needs access to a Proxmox ISO storage directory. Common locations:

These settings must be enabled in your motherboard BIOS/UEFI before creating a macOS VM.

Setting	Where to Find It
VT-x (Intel) or AMD-V (AMD)	CPU or Advanced settings
VT-d (Intel) or AMD IOMMU (AMD)	Chipset or Advanced settings -- required for GPU passthrough

warning

Without VT-x/AMD-V enabled, the VM will not start. If you plan to use GPU passthrough, VT-d/IOMMU is also required.

Stable TSC (Time Stamp Counter) flags reduce clock drift and VM lag. Verify with:

lscpu | grep -E 'Model name|Flags'

Look for constant_tsc and nonstop_tsc in the output. Most modern CPUs have these flags.

Once your hardware is confirmed, proceed to Installation.