How luchina-gabriel/osx-proxmox works
OSX-PROXMOX is a Proxmox setup for running macOS VMs on Intel or AMD hardware. The documented user journey starts in the Proxmox shell, runs the installer, and proceeds to install macOS; the repository also supplies OpenCore EFI profiles, patches, host reports, and a macOS recovery-download utility. The README establishes the product capabilities, but installer and setup source was not excerpted, so their internal handoffs are shown only as unverified dashed links. The sampled recovery code supports the utility’s request, download, and verification relationships.
Main entry points: setup VM Setup · macrecovery.py Recovery CLI · install.sh Installer · config.plist NVIDIA Profile
Components 16
EFI Boot Profiles
- NVIDIA Profile
EFI/Source/EFI-Nvidia-HS/EFI/OC/config.plist - VM Profile
EFI/Source/EFI-VirtualMachine-Only - Pikera Enabled
EFI/Source/EFI-pikera-ON - Pikera Disabled
EFI/Source/EFI-pikera-OFF - OpenCore Bootloader
EFI/Source/EFI-Nvidia-HS/EFI/OC/OpenCore.efi
Recovery Utility
- Recovery CLI
tools/macrecovery/macrecovery.py - Apple Recovery Service
- Image Download
tools/macrecovery/macrecovery.py - Chunk Verification
tools/macrecovery/macrecovery.py - Recovery Images
Patches and Reports
- Proxmox Reports
Artefacts - VM Patches
Patches
Other components
- Proxmox Operator
- Proxmox VE
Connections 17
- Proxmox Operator → Installer: runs
README.md - Installer → VM Setup: hands off
- VM Setup → Proxmox VE: configures
README.md - VM Setup → NVIDIA Profile: selects
- VM Setup → VM Profile: selects
- VM Setup → Pikera Enabled: selects
- VM Setup → Pikera Disabled: selects
- NVIDIA Profile → OpenCore Bootloader: configures
- Proxmox Operator → Recovery CLI: invokes
- Recovery CLI → Apple Recovery Service: requests metadata
tools/macrecovery/macrecovery.py - Recovery CLI → Image Download: starts download
tools/macrecovery/macrecovery.py - Image Download → Apple Recovery Service: fetches image
tools/macrecovery/macrecovery.py - Image Download → Recovery Images: writes image
tools/macrecovery/macrecovery.py - Recovery CLI → Chunk Verification: verifies image
tools/macrecovery/macrecovery.py - Chunk Verification → Recovery Images: reads image
tools/macrecovery/macrecovery.py - Proxmox Operator → Proxmox Reports: consults
- Proxmox Operator → VM Patches: applies