lucid-fabrics /osx-proxmox-next
One-command macOS VM on Proxmox 9: TUI wizard, auto-download, AMD + Intel, Sonoma/Sequoia/Tahoe
★ 304⑂ 22👁 4⑃ 125● 37▤ 83
+0
日增长
304
stars
22
forks
4
watchers
125
prs
37
issues
83
releases
README
🍏 OSX Proxmox Next
You're losing 3–6 hours every time you set up a macOS VM on Proxmox.
OpenCore plist editing. GenSMBIOS. Manual qm commands. One wrong flag and you start over.
osx-proxmox-next does it in under 5 minutes. One command. Guided wizard. Done.
🎮 New in v0.32: guided GPU passthrough. AMD Radeon with native macOS drivers, and NVIDIA RTX 20 to 50 through the community NullMoth driver (beta), and the Intel iGPU through WhateverXe (beta).
One command walks you through the BIOS, the host and the VM: osx-next-cli gpu-setup · How it works
---
🧰 Stop Wasting Afternoons on macOS VMs
The manual route eats your time: find the right OpenCore build, edit plist files, run GenSMBIOS, copy ISOs, type out qm commands, debug boot failures, repeat. Most people give up or spend a full day getting it right once - then forget the steps by the next time.
osx-proxmox-next replaces all of it with a 6-step wizard that runs on your Proxmox host.
You get:
- A 6-step TUI wizard: Preflight OS Storage Config Dry Run Install
- Guided GPU passthrough (BETA): scan your cards, get a BIOS photo card with a QR code for your board, let the tool set up the host and attach the card, undo it all with one command. AMD Radeon natively, NVIDIA RTX 20 to 50 via the community NullMoth driver, the Intel iGPU via WhateverXe
- Unattended install (BETA): tick one box and walk away - the tool erases the new disk, runs the installer, and answers every reboot until macOS sits at Setup Assistant
- OpenCore boot image assembled on your host from pinned, checksum-verified upstream releases - no opaque prebuilt blob
- Auto-detected hardware defaults (CPU vendor, cores, RAM, storage targets)
- Intel, Xeon, and AMD CPU support - auto-detected, zero configuration needed
- Automatic OpenCore and recovery/installer download - no manual file placement
- Shared storage support - download ISOs to NAS or any Proxmox storage pool (--iso-dir)
- Auto-generated SMBIOS identity (serial, UUID, model) - no OpenCore editing needed
- Graphical boot picker with Apple icons - waits for your choice during install, auto-boots once post-install runs
- Mandatory dry-run before live install previews every command
- Real-time form validation with inline error feedback
How It Compares
| | Manual setup | osx-proxmox-next |
|---|---|---|
| Time to first boot | 3–6 hours | |
If this already looks better than what you've been doing - ⭐ star the repo and help others find it.
Demo
Wizard (6 steps: Preflight → OS → Storage → Config → Dry Run → Install), including the Unattended install (BETA) toggle:
!osx-proxmox-next TUI wizard demo
CLI tools (preflight, plan, doctor):
!osx-proxmox-next CLI demo
TUI Preview
Step 1: Preflight Checks
Step 2: OS Selection
Step 4: VM Configuration (Top issues
Discussions
#121Which macOS version for lowest idle CPU?0 comments · 2026-08-17#51Created VM and installed Sonomo without any errors, but does not boot Sonoma3 comments · 2026-03-09#34What's latest discord invite?0 comments · 2026-03-06
Latest release
v0.35.2 v0.35.2 2026-11-13Bug Fixes - fix(unattended): keep qm monitor off the controlling terminal (166) Other Changes - chore(release): v0.35.2 Full changelog: https://github.com/lucid-fabrics/osx-proxmox-next/compare/v0.35.1...v0.35.2 --- Quick Start bash sudo bash -c "$(curl -fsSL https://raw.githubusercontent.com/lucid-fabrics/osx-proxmox-next/main/install.sh)" ☕ Support: Ko-fi | Buy Me a Coffee