How To Fix An Error Occurred While Preparing macOS Install (2026)
The message An error occurred while preparing the installation appears when the macOS installer fails before it starts copying the system.
Apple groups it with the other errors that can show up while downloading, preparing or installing macOS, and gives one ordered list of fixes for all of them.
This guide walks through that list, with the exact steps Apple gives for each stage.
Quick answer: what to try, in order
| Order | Check | What to do |
|---|---|---|
| 1 | Storage | Free up space if the error mentions storage |
| 2 | Internet | Confirm the Mac is online with a stable connection |
| 3 | Recovery | Install from macOS Recovery so other software cannot interfere |
| 4 | Disk repair | Run First Aid on the startup disk, and re-download a damaged installer |
| 5 | Firmware | On Apple silicon or T2 Macs, revive or restore firmware as a rare step |
| 6 | Erase | Erase the Mac and set it up again as a last resort |
| 7 | Apple | Contact Apple Support if the problem continues |
What the message means
Apple says messages such as an error occurred while downloading, preparing or installing, or that the software is damaged or could not be verified, can have several causes.
Apple also says some of these problems are temporary, so trying the install again later is reasonable.
If the Mac was already trying to update when this appeared, our guide to a Mac that will not update macOS covers that route.
Free up storage space
If the error says your Mac does not have enough storage, Apple’s first step is to free up space.
Our guide to freeing up storage on a Mac shows where the space is going and how to clear it.
Check the internet connection
Apple says the installer needs a stable connection to download macOS and Mac-specific firmware.
- Confirm the Mac is online.
- Move closer to the router or use Ethernet if you can.
- If it keeps failing, try a different network.
Apple warns that installing from Recovery needs a broadband connection using DHCP over Wi-Fi or Ethernet.
Networks that require a captive-network login, 802.1X security or PPPoE, unless a router handles PPPoE, can prevent installation.
Install from macOS Recovery
Apple suggests installing from macOS Recovery because it keeps other software from interfering with the installer.
| Mac type | How to start macOS Recovery |
|---|---|
| Apple silicon | Shut down, hold the power button until Loading startup options appears, click Options, then Continue |
| Intel | Shut down, press the power button, then immediately hold Command-R until an Apple logo or spinning globe appears |
- If asked, choose a Wi-Fi network or connect an Ethernet cable.
- If asked, select your startup disk and a user whose password you know.
- Choose Reinstall macOS in the Recovery utilities and click Continue.
- Follow the onscreen steps and let the install finish.
If the Mac cannot reach Apple from Recovery, see our guide to the recovery server could not be contacted message.
What to expect while it installs
Apple says not to put the Mac to sleep or close its lid while macOS installs.
The Mac may restart several times, and the screen may stay blank for several minutes.
- If asked to unlock the disk, enter the password you use to log in.
- If offered Macintosh HD or Macintosh HD – Data, choose Macintosh HD.
Apple says reinstalling from Recovery does not remove your apps or personal data, though it recommends a backup first.
Use safe mode if you install from the App Store
Apple says that if you install through the App Store or Software Update instead of Recovery, you may also start in safe mode before installing.
| Mac type | How to start in safe mode |
|---|---|
| Apple silicon | Shut down, hold the power button until startup options appear, select a volume, hold Shift and click Continue in Safe Mode |
| Intel | Turn on or restart and hold Shift until the login window appears |
Safe Boot appears in the menu bar at the login window when safe mode is on.
Repair the startup disk
Apple says to run Disk Utility’s repair from macOS Recovery, and to skip this step if you just erased the startup disk.
- In Recovery, choose Disk Utility and click Continue.
- Choose View > Show All Devices if it is available.
- Select the last volume on the startup disk, such as Macintosh HD – Data, and click First Aid, then Run.
- Work up the list to each volume group, each container and finally the device.
If First Aid keeps failing, Apple says to back up what you can, reformat the disk, reinstall macOS and restore your data.
Re-download a damaged installer
If the installer is reported as damaged or cannot be verified, Apple says to delete it, repair the disk and download the installer from Apple again.
Our guide to a disk that could not be partitioned shows the same First Aid steps in more detail.
If the installer does not see your disk
Apple says to quit the installer, open Disk Utility from Recovery and erase the startup disk.
Erasing deletes everything on that disk, so do this only if you have a backup or nothing on the disk matters.
If Disk Utility cannot see or erase the disk, Apple says the Mac may need service.
Revive or restore firmware
Apple calls this rare, and it applies only to Macs with Apple silicon or the Apple T2 Security Chip whose firmware is corrupted.
| Option | What it does |
|---|---|
| Revive Mac | Typically faster and does not erase your data, so Apple says to try it first |
| Restore Mac | Erases the Mac and returns it to factory settings, so use it only if reviving fails |
- You need a second Mac running macOS 14 or later, online, with about 60 GB of free storage.
- You need a USB-C to USB-C cable that supports data and charging, not a Thunderbolt 3 cable.
- Key timing matters when you put the affected Mac into DFU mode.
Apple lists a macOS installation error that other fixes do not resolve as one reason to use this.
When to contact Apple
Apple’s last two steps are to erase the Mac and set it up again, and then to contact Apple Support if the problem continues.
If Disk Utility cannot see the disk or Apple Diagnostics reports a fault, the Mac likely needs service.