https://github.com/grahampugh/erase-install

A script that automates downloading macOS installers, and optionally erasing or upgrading macOS in a single process. Watch the video!
https://github.com/grahampugh/erase-install

apple erase mac macos operating-system reinstall upgrade

Last synced: 9 days ago
JSON representation

A script that automates downloading macOS installers, and optionally erasing or upgrading macOS in a single process. Watch the video!

• Host: GitHub
• URL: https://github.com/grahampugh/erase-install
• Owner: grahampugh
• License: apache-2.0
• Created: 2018-07-10T11:21:27.000Z (over 6 years ago)
• Default Branch: main
• Last Pushed: 2024-09-17T17:51:14.000Z (about 2 months ago)
• Last Synced: 2024-10-25T05:52:06.656Z (15 days ago)
• Topics: apple, erase, mac, macos, operating-system, reinstall, upgrade
• Language: Shell
• Homepage: https://grahamrpugh.com/2023/05/14/macaduk-presentation-eraseinstall.html
• Size: 16.5 MB
• Stars: 841
• Watchers: 64
• Forks: 133
• Open Issues: 13
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml
  • License: LICENSE

Awesome Lists containing this project

• awesome-macadmin-tools - https://github.com/grahampugh/erase-install

README

        
# erase-install

by Graham Pugh

![](https://img.shields.io/github/v/release/grahampugh/erase-install) ![](https://img.shields.io/github/downloads/grahampugh/erase-install/latest/total) ![](https://img.shields.io/github/downloads/grahampugh/erase-install/total) ![](https://img.shields.io/badge/macOS-11%2B-success) ![](https://img.shields.io/github/license/grahampugh/erase-install)

**Note:** 

The default (`main`) branch is the latest code commit of the production track, which represents versions 28.0 and newer. Any Pull Requests should be made to the `main` branch.

The `release` branch should correspond to the current latest release.

The `legacy` branch is the latest code commit of the legacy track, which represents versions up to 27.x. The legacy track is for those who need to use this script on macOS 10.15 or older.

---

**WARNING. This is a self-destruct script. Do not try it out on your own device!**

`erase-install.sh` is a script to reinstall macOS directly from the system volume using `startosinstall`, a resource binary which has been built into macOS installer applications since version 10.12.4. The `--eraseinstall` option was added with macOS 10.13.4 for computers with an APFS system volume.

**It can be used to download, reinstall, upgrade or erase macOS.**

The script is designed to interact with [mist-cli](https://github.com/ninxsoft/mist-cli), a script developed by Nindi Gill, in order to download a macOS Installer application directly from Apple to the client. The minimum required version is macOS 10.15.

It is alternatively possible to use the `softwareupdate --fetch-full-installer` command on Mac computers running **macOS 11 or greater** (macOS 11 is required because the `--list-full-installers` option is used to find valid builds).

The script is also designed to interact with [swiftDialog](https://github.com/bartreardon/swiftDialog) for providing dialogues to users. **The minimum required version for swiftDialog is macOS 11**.

The script has many options to suit a large variety of workflows, management tools and user experiences. Originally designed to work with Macs that are enrolled into Jamf Pro, it now has additional options for use with other management systems or no management systems at all.

## [Please refer to the Wiki for detailed documentation](https://github.com/grahampugh/erase-install/wiki)