I Built a One-Command macOS VM Tool for Proxmox 9

Source: Dev.to

What I Built

osx-proxmox-next – a TUI wizard that runs on a Proxmox 9 host and automates the whole process in five steps:

1. Pre‑flight checks – verifies qm, pvesm, /dev/kvm, and root access.
2. Auto‑detect – suggests CPU, RAM, storage, and picks a free VMID.
3. Review – validates the configuration and checks that the OpenCore and installer ISOs exist.
4. Dry Run – displays every qm command that will be executed; nothing is run yet.
5. Live Apply – creates the VM.

The dry‑run mode is the most useful part: you see exactly what will happen before anything touches your system.

Automatic SMBIOS Generation

Every macOS VM needs a unique serial number, UUID, and board model, or Apple services won’t work. Most guides require you to generate these manually and edit OpenCore configs.
osx-proxmox-next generates them automatically via Proxmox’s native --smbios1 flag—no OpenCore editing needed. You can provide your own values if you prefer.

Installation

bash -c "$(curl -fsSL https://raw.githubusercontent.com/wmehanna/osx-proxmox-next/main/install.sh)"

The script clones the repository, sets up a Python virtual environment, and launches the wizard.

CLI Usage (for scripting)

# Preview commands (dry run)
osx-next-cli apply \
  --vmid 910 --name macos-sequoia --macos sequoia \
  --cores 8 --memory 16384 --disk 128 \
  --bridge vmbr0 --storage local-lvm

# Execute for real
osx-next-cli apply --execute \
  --vmid 910 --name macos-sequoia --macos sequoia \
  --cores 8 --memory 16384 --disk 128 \
  --bridge vmbr0 --storage local-lvm

Supported macOS Versions

Optional Guest‑Side Scripts

Tip: Snapshot your VM before applying either script.

Roadmap

• Reusable VM templates
• Automatic OpenCore updates
• GPU passthrough wizard (stretch goal, requires 20 sponsors)

Repository & Sponsorship

• GitHub:
• This is a solo project with no corporate backing. If it saves you time, consider starring the repo, buying a coffee, or sponsoring on GitHub.