Generate bootable macOS installer ISO or DMG images directly from Apple’s servers via GitHub Actions. Includes intelligent size optimization to produce the smallest possible installer images.
Supported formats:
- ISO – True DVD format compatible with Proxmox VE, QEMU, VirtualBox, and VMware
- DMG – For creating bootable macOS installer USB drive on Windows/Linux with
dd,BalenaEtcher,Rufus
Workflows available:
- macOS Recovery ISO (Recommended) – Lightweight recovery image (build takes ~2-5 min) • Best for virtualization
- macOS Full Installer – Complete offline installer (build takes ~20-60 min, 5-18GB) • Best for offline use
Important
- Download the macOS Recovery ISO from the Releases page — it’s all you need to install macOS in a VM.
- If you really need the full macOS installer, build it inside your macOS VM using the Create_macOS_ISO.command script.
- GitHub-hosted runners are a free public resource — please use them responsibly.
-
Fork this repository.
-
Go to the Actions tab in your forked repository.
-
Click the green button "I understand my workflows, go ahead and enable them".
-
Select the "Build macOS Installer ISO/DMG image" workflow.
-
Click the "Run workflow" button.
-
Configure the workflow inputs:
- macOS version – Choose a version (Sequoia, Sonoma, etc.).
- Image format – Choose
isofor virtual machines ordmgfor bootable USB drives. - Specific version (optional) – Enter a version like
15.6.1, or leave blank for the latest.
-
Click the green button "Run workflow" to start the build.
-
Wait for the workflow to complete (this may take 20-60 minutes).
-
Open the completed workflow run and scroll to the Artifacts section.
-
Download the artifact (e.g.,
macOS-Sequoia-15.6.1-ISO).
Tip
Enable Cloudflare WARP for faster downloads.
- Extract the ZIP file to get your
.isoor.dmgfile.
Note
By default, artifacts are kept for 5 days. You can change this in the workflow YAML file.
Tip
- For best performance, use a macOS VM on Proxmox VE with iGPU or dGPU passthrough.
- Install macOS on Proxmox VE using LongQT-sea/OpenCore-ISO.
- For Intel GVT-d iGPU passthrough, see LongQT-sea/intel-igpu-passthru.
This tool downloads macOS images directly from Apple's servers. Users are responsible for complying with Apple's Software License Agreement.