Repository files navigation

Generate bootable macOS installer ISO or DMG images directly from Apple servers via GitHub Actions. Includes intelligent file size optimization to achieve absolute smallest possible installer images.

Supported formats:

• ISO – True DVD format compatible withProxmox VE,QEMU,VirtualBox, andVMware
• DMG – For creating bootable macOS installer USB drive on Windows/Linux withdd,BalenaEtcher,Rufus

Workflows available:

• macOS Recovery ISO (Recommended) – Lightweight recovery image (build takes ~2-10 min) • Best for virtualization
• macOS Full Installer – Complete offline installer (build takes ~20-60 min, 5-16GB) • Best for offline use

1. Fork this repository.

2. Go to theActions tab in your forked repository.

3. Click the green button"I understand my workflows, go ahead and enable them".

4. Select the"Build macOS Installer ISO/DMG image" workflow.

5. Click the"Run workflow" button.

6. Configure the workflow inputs:

   • macOS version – Choose a version (Sequoia,Sonoma, etc.).
   • Image format – Chooseiso for virtual machines ordmg for bootable USB drives.
   • Specific version(optional) – Enter a version like15.6.1, or leave blank for the latest.

7. Click the green button"Run workflow" to start the build.

8. Wait for the workflow to complete (this may take 15-60 minutes).

9. Open the completed workflow run and scroll to theArtifacts section.

10. Download the artifact (e.g.,macOS-Sequoia-15.6.1-ISO).

11. Extract the ZIP file to get your.iso or.dmg file.

You may occasionally encounterhdiutil: couldn't eject "disk4" - Resource busy. If this occurs, simply re-run the workflow.

This tool downloads macOS images directly from Apple's servers. Users are responsible for complying with Apple's Software License Agreement.