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
下载:v0.35.2v0.35.2 ↓0.35.22026-11-13
+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

Latest release

v0.35.2 v0.35.2 2026-11-13
Bug 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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON