MacOS Install Error Occurred? Fixes That Work

The “An error occurred while preparing the installation” message appears when macOS setup fails during a major upgrade or reinstall, often before the installer finishes copying files. The fix is usually to free up storage, reset the installer cache, or re-download the macOS installer, and in stubborn cases, erase the target disk or use a bootable USB drive. Below are the concrete steps to resolve it, why the error happens, and how to avoid it next time.

What Causes the “Error Occurred While Preparing macOS” Message

This error is not a single fault code but a catch-all that macOS shows when the installer cannot complete its pre-flight checks. The most common triggers are:

Insufficient free storage – macOS needs roughly 20–30 GB free for a major upgrade, plus extra for temporary files.
A corrupted or incomplete installer – a partial download or a damaged .app bundle can fail validation.
Date and time out of sync – certificate checks fail if the clock is wrong, which blocks the installer.
Third-party software interference – antivirus, cleanup tools, or even a misbehaving login item can lock files the installer needs.
Disk errors or a failing drive – bad sectors or a full APFS container can halt preparation.
Old installer cache – leftover files in /Library/Installer or the macOS installer’s own cache can conflict.

In many cases the error appears after you click “Install” and the progress bar sits at “Preparing the installation” for several minutes before failing. The exact wording may vary slightly (“An error occurred while preparing the installation” or “The installation failed”), but the cause and fixes are the same.

Before You Start: Quick Pre-Flight Checks

Spend two minutes on these basics before diving into more invasive fixes. They resolve a surprising number of cases.

Check free space – Go to Apple menu ▸ About This Mac ▸ Storage. You want at least 30 GB free for a full upgrade; more is better if you have a large library.
Sync the clock – Open System Settings ▸ General ▸ Date & Time and turn on “Set time and date automatically.” If it’s already on, toggle it off and on.
Quit unnecessary apps – Especially any antivirus, VPN, or “cleaner” utilities. They can hold locks on system files.
Restart your Mac – A clean boot clears temporary locks and resets the installer’s state.

If the error persists, move on to the targeted fixes below.

Fix 1: Free Up Storage and Remove the Installer Cache

macOS’s installer is notoriously greedy with temporary space. Even if you have 20 GB free, the preparation phase can create a second copy of the installer plus logs and caches. To clear the cache:

Open Finder and press Cmd+Shift+G to “Go to Folder.”
Type /Library/Installer and press Enter. Look for a folder named Temp or Updates – drag its contents to the Trash (you’ll need admin rights).
Also check ~/Library/Installer (your user folder) for leftover temp files.
Empty the Trash, then restart.

If you’re very short on space, use the built-in Storage Management tool (Apple menu ▸ About This Mac ▸ Storage ▸ Manage) to delete large files, old iOS backups, and caches. A good rule of thumb: free up 10% of your drive’s capacity or at least 30 GB, whichever is larger.

Fix 2: Re-Download the Installer (or Use a Bootable USB)

A corrupted download is one of the most common causes. Delete the installer you have and fetch a fresh copy.

Open Applications and find the macOS installer (e.g., “Install macOS Sonoma”). Drag it to the Trash.
Re-download it from the Mac App Store (for the latest version) or from Apple’s support page for older releases.
If you’re trying to upgrade to a beta or a version you already have, use the Software Update pane in System Settings instead – it handles the download more reliably.

If you have another Mac, create a bootable USB drive using the createinstallmedia command. This bypasses the local installer entirely and often succeeds when the normal route fails. The exact command is:

sudo /Applications/Install\ macOS\ Sonoma.app/Contents/Resources/createinstallmedia --volume /Volumes/MyUSB

Replace the app name and volume name with your own. Then boot from the USB (hold Option at startup) and install from there.

Fix 3: Erase the Target Disk (If You’re Reinstalling)

If you’re reinstalling macOS because your system is unstable, the error may be caused by a corrupted existing system volume. In that case, erasing the disk and doing a clean install is the most reliable fix.

Boot into macOS Recovery: restart and hold Cmd+R (or Power on Apple Silicon until you see “Loading startup options”).
Open Disk Utility from the Recovery window.
Select your internal drive (the top-level item, not the volumes below it) and click Erase.
Choose APFS (or Mac OS Extended for older systems) and GUID Partition Map, then erase.
Quit Disk Utility and choose Reinstall macOS.

This wipes everything on the drive, so back up first. If you’re not comfortable erasing, skip this step and try the next one.

Fix 4: Reset NVRAM and Check Disk Health

On Intel Macs, resetting NVRAM (non-volatile RAM) can clear boot settings that interfere with the installer. Shut down, then power on and immediately hold Option+Cmd+P+R for about 20 seconds. On Apple Silicon, NVRAM resets automatically – you can’t do it manually.

Also run First Aid on your disk to rule out file-system errors:

Boot into Recovery (Cmd+R).
Open Disk Utility, select your startup disk, and click First Aid – then Run.
If it reports errors, let it fix them, then try the installation again.

If First Aid finds persistent errors, your drive may be failing. Back up immediately and consider replacing it.

When to Use Safe Mode or a Different Network

Safe Mode loads only essential extensions and disables login items, which can eliminate software conflicts.

Restart and hold Shift (Intel) or press and hold the power button until “Loading startup options” appears, then select your disk and choose Safe Mode (Apple Silicon).
Once booted, try the installation again.

If the error persists, try a different network. A flaky Wi-Fi connection can corrupt the download mid-way, and the installer may not detect it until preparation. Use Ethernet if possible, or a different Wi-Fi network.

Frequently Asked Questions

Will I lose my files if I erase the disk? Yes, erasing wipes everything. Back up to an external drive or iCloud before doing a clean install. If you have a Time Machine backup, you can restore after installation.

Why does the installer say “preparing” for so long? It’s copying the installer to a hidden partition and verifying its digital signature. On older Macs or slow drives, this can take 10–15 minutes. If it fails after that, it’s usually a storage or cache issue.

Can I install an older macOS version if the latest one fails? Yes, you can download older installers from Apple’s support page, but you may need to format your disk as Mac OS Extended (Journaled) for very old versions. Check the system requirements first.

Does this error mean my Mac is broken? Not usually. It’s almost always a software or storage problem. Only if First Aid reports hardware errors should you suspect a failing drive.

Is it safe to use third-party “macOS cleaner” apps to fix this? Avoid them. They often remove files the installer needs and can make the problem worse. Stick to the built-in tools.

What if none of these fixes work? If you’ve tried freeing space, re-downloading, safe mode, and a clean install, the issue may be a hardware fault (RAM, drive, or logic board). Contact Apple Support or an authorized service provider.

General steps for current mainstream versions; menus can differ by device and version. See the disclaimer or report an error.

More in this bed

The whole Tech How-To bed →