I Got Tired of Manually Configuring macOS VMs — So I Built a One-Click Solution

#proxmox #macos #homelab #opensource

Every Proxmox user knows that moment. You want to spin up a macOS VM for testing, iOS development, or just playing around. And then the nightmare begins.

You Google "macOS Proxmox guide". You find a tutorial from 2021. You copy-paste commands, tweak OpenCore configs, mess up one flag, and suddenly you are staring at a UEFI shell wondering what went wrong. Again.

I lived this cycle for years. Every. Single. Time.

The Pain Was Real

I would spend hours:

Finding a current guide (most are outdated)
Chaining together qm commands
Manually generating SMBIOS serials
Editing OpenCore config.plist files
Praying it boots

And when it finally worked? I would not save my config. So next time, I would do it all over again.

I got fed up.

Enter osx-proxmox-next

I built a tool that handles the entire VM creation process in a guided wizard. No manual commands. No config editing. Just answer a few questions and boom — your macOS VM is ready.

What It Does

6-step TUI wizard — Preflight → OS → Storage → Config → Dry Run → Install
Auto-detects your hardware — CPU vendor, cores, RAM, storage pools
Both Intel and AMD supported — zero config needed
Auto-downloads everything — OpenCore ISOs and macOS recovery images
Generates SMBIOS identity — unique serial, UUID, model for Apple Services
Mandatory dry-run — see every command before it runs

Quick Look

macOS	Status
Ventura 13	Stable
Sonoma 14	Stable
Sequoia 15	Stable
Tahoe 26	Stable

Why This Matters

macOS on Proxmox is niche. Most guides are buried in forums or outdated. Existing scripts are rough — no validation, no dry run, no error handling.

I wanted something that just works. Something I could trust. Something that shows me exactly what it will do before it does it.

That is osx-proxmox-next.

Install

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

CLI Mode

Prefer command line? Got you covered:

# Download assets
osx-next-cli download --macos sonoma

# Preview (dry run)
osx-next-cli apply --vmid 910 --macos sequoia --cores 8 --memory 16384 --disk 128

# Execute
osx-next-cli apply --execute --vmid 910 --macos sequoia --cores 8 --memory 16384 --disk 128

This Is Solo Work

I maintain this project in my free time. No company. No team. Just me, trying to make macOS VMs on Proxmox less painful for anyone else who has to go through it.

If this saves you hours of frustration — a star on the repo or a coffee would mean a lot.

☕ Ko-fi | Buy Me a Coffee | ⭐ Star on GitHub