{"id":51071829,"url":"https://github.com/wlfogle/proxmox-macos","last_synced_at":"2026-06-23T11:02:21.425Z","repository":{"id":366273755,"uuid":"1275701354","full_name":"wlfogle/proxmox-macos","owner":"wlfogle","description":"One-script macOS Tahoe (26) VM on Proxmox — AMD CPU + RX 580 GPU passthrough, headless/NomMachine","archived":false,"fork":false,"pushed_at":"2026-06-21T03:30:43.000Z","size":13,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-06-21T05:10:10.672Z","etag":null,"topics":["amd","hackintosh","homelab","kvm","macos","opencore","proxmox","qemu","radeon","tahoe"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/wlfogle.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-21T03:14:58.000Z","updated_at":"2026-06-21T03:30:46.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/wlfogle/proxmox-macos","commit_stats":null,"previous_names":["wlfogle/proxmox-macos"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/wlfogle/proxmox-macos","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wlfogle%2Fproxmox-macos","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wlfogle%2Fproxmox-macos/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wlfogle%2Fproxmox-macos/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wlfogle%2Fproxmox-macos/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wlfogle","download_url":"https://codeload.github.com/wlfogle/proxmox-macos/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wlfogle%2Fproxmox-macos/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34686726,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-23T02:00:07.161Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["amd","hackintosh","homelab","kvm","macos","opencore","proxmox","qemu","radeon","tahoe"],"created_at":"2026-06-23T11:02:20.088Z","updated_at":"2026-06-23T11:02:21.420Z","avatar_url":"https://github.com/wlfogle.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# proxmox-macos\n\n**One-script macOS Tahoe (26) VM on Proxmox — AMD + RX 580 GPU passthrough, headless/NomMachine**\n\nAutomated, non-interactive setup script for running macOS Tahoe on Proxmox VE 9 with an AMD CPU and Radeon GPU. No manual `qm` commands, no OpenCore editing, no config.plist fiddling.\n\n## Hardware (tested on)\n\n| Component | Spec |\n|-----------|------|\n| CPU | AMD Ryzen 5 3600 |\n| GPU | AMD Radeon RX 580 (Ellesmere) |\n| RAM | 32 GB |\n| Hypervisor | Proxmox VE 9.2.3 |\n| macOS | Tahoe 26.5.1 |\n\n## Prerequisites\n\nOn your Proxmox host, ensure the following are already set in `/etc/default/grub`:\n\n```\nGRUB_CMDLINE_LINUX_DEFAULT=\"quiet amd_iommu=on iommu=pt vfio-pci.ids=1002:67df,1002:aaf0\"\n```\n\nAnd in `/etc/modprobe.d/kvm.conf`:\n\n```\noptions kvm ignore_msrs=Y report_ignored_msrs=0\n```\n\nRun `update-grub \u0026\u0026 update-initramfs -u -k all` and reboot the host once.\n\n## Usage\n\n### Phase 1 — Install macOS\n\nCopy the script to your Proxmox host and run it as root:\n\n```bash\nscp install-macos-tahoe-tiamat.sh root@proxmox:/root/\nssh root@proxmox \"bash /root/install-macos-tahoe-tiamat.sh\"\n```\n\nThe script will:\n1. Check for existing ISOs — downloads only what's missing\n2. Create VM 103 (`macos-tahoe`) via [osx-proxmox-next](https://github.com/lucid-fabrics/osx-proxmox-next)\n3. Apply AMD-optimised QEMU args (Cascadelake-Server emulation)\n4. Set `vga: vmware` so Proxmox noVNC works during installation\n5. Start the VM\n\nThen open **Proxmox web UI → VM 103 → Console** and complete the macOS installer:\n\n1. OpenCore picker → **macOS Base System**\n2. Disk Utility → Erase VirtIO disk → **APFS / GUID**\n3. Install macOS Tahoe (~15 GB download from Apple)\n4. VM reboots 2–3× automatically\n5. `Less than a minute` hang = APFS sealing — **wait 90+ minutes**\n\n### Phase 2 — Post-install\n\nInside macOS (via noVNC):\n\n```bash\n# Mount and copy OpenCore EFI to disk\n# Open LongQT-OpenCore on Desktop → Mount_EFI.command\ncp -R /Volumes/LongQT-OpenCore/EFI_RELEASE/EFI /Volumes/EFI/\n```\n\nInstall [NomMachine](https://www.nomachine.com/download) for persistent remote access.\n\n### Phase 3 — Enable GPU passthrough\n\nOnce NomMachine is running inside macOS, run on the Proxmox host:\n\n```bash\nbash /root/install-macos-tahoe-tiamat.sh --enable-gpu\n```\n\nThis stops the VM, adds RX 580 passthrough (`vga: none`), and restarts. NomMachine/Moonlight will use the GPU.\n\n## Idempotent\n\nRe-running the script is safe at any point. If the VM already exists, it skips creation and re-applies the full config. Useful for fixing a broken config without starting over.\n\n## QEMU Args\n\n```\n-device isa-applesmc,osk=...\n-smbios type=2\n-device qemu-xhci\n-device usb-kbd -device usb-tablet\n-global nec-usb-xhci.msi=off\n-global ICH9-LPC.acpi-pci-hotplug-with-bridge-support=off\n-cpu Cascadelake-Server,vendor=GenuineIntel,+invtsc,-pcid,-hle,-rtm,\n     -avx512f,-avx512dq,-avx512cd,-avx512bw,-avx512vl,-avx512vnni,\n     kvm=on,vmware-cpuid-freq=on\n```\n\n- `Cascadelake-Server` — named Intel CPU model; [30–44% faster than `-cpu host`](https://github.com/LongQT-sea/qemu-cpu-guide#macos-guests) for macOS\n- `vendor=GenuineIntel` — required by macOS CPUID check\n- `+invtsc` — fixes AMD TSC synchronisation (kernel panic without this)\n- AVX-512/TSX/PCID disabled — not present on Ryzen 3600\n\n## Sources\n\n- [osx-proxmox-next](https://github.com/lucid-fabrics/osx-proxmox-next) — VM creation tool\n- [LongQT-sea/OpenCore-ISO](https://github.com/LongQT-sea/OpenCore-ISO) — OpenCore for Proxmox\n- [OSX-KVM](https://github.com/kholia/OSX-KVM) — QEMU/KVM macOS reference\n- [Dortania OpenCore Guide](https://dortania.github.io/OpenCore-Install-Guide/)\n- [tonymacx86 Tahoe guide](https://www.tonymacx86.com/threads/howto-macos-26-tahoe-with-opencore-1-0-5-z390-i9-9900-rx-6600-xt.332345/)\n\n## License\n\nMIT\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwlfogle%2Fproxmox-macos","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwlfogle%2Fproxmox-macos","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwlfogle%2Fproxmox-macos/lists"}