macOS Installation Couldn’t Be Completed? Fixes

If you see “The macOS installation couldn’t be completed” during an upgrade or fresh install, the cause is usually a corrupted installer, insufficient storage, or a problem with the startup disk’s format. Restart your Mac, ensure you have at least 20–30 GB of free space, and try the installation again—if it fails, re-download the installer or use Disk Utility to repair the disk.

What This Error Means

macOS shows this generic message when the installer cannot finish writing system files to your startup disk. It can appear at the beginning, middle, or very end of the installation, often after a restart. The wording is intentionally broad—Apple uses it for any failure that prevents the operating system from being placed correctly on the drive.

Common triggers include:

• A partial or corrupted download of the macOS installer
• Insufficient free space on the target disk
• A disk that is formatted incorrectly (e.g., Mac OS Extended instead of APFS)
• Third-party startup agents or security software interfering
• Failing hardware, especially the SSD or RAM

Before You Try Anything Else

Start with the simplest checks, because they resolve a large percentage of cases.

1. Restart your Mac. A clean reboot clears temporary files and resets the installer’s state.
2. Check storage. Go to Apple menu › System Settings › General › Storage. You need at least 20–30 GB free, more if you are upgrading from an older version.
3. Ensure you are connected to power. If you are on a laptop, plug it in. The installer will not proceed on battery alone in some cases.
4. Disconnect unnecessary peripherals. Remove external drives, hubs, and dongles that could confuse the installer.

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

Re-download the Installer

A corrupted download is the most common culprit. The macOS installer is a multi-gigabyte file, and any interruption or glitch can leave it incomplete. Delete the installer you have and fetch a fresh copy.

1. Open Finder › Applications. Find the installer (e.g., “Install macOS Sonoma”).
2. Drag it to the Trash, then empty the Trash.
3. Re-download from the Mac App Store or using the softwareupdate --fetch-full-installer command in Terminal.
4. If you are using a USB installer, create it again with the new download using createinstallmedia.

After re-downloading, try the installation again. This alone fixes many cases where the error appears right after the first restart.

Repair the Disk with Disk Utility

Disk directory errors or a failing drive can cause the installer to fail partway through. You can check and repair the disk without erasing it.

1. Restart your Mac and hold Command + R to enter Recovery Mode.
2. Open Disk Utility from the Utilities window.
3. Select your startup disk (usually “Macintosh HD”) in the sidebar.
4. Click First Aid and then Run. Let it complete; it may take several minutes.
5. If it reports errors, run First Aid again until it says no problems found.

If First Aid cannot fix the disk, you may need to erase it and reinstall macOS. Back up your data first if possible.

Check the Disk Format

macOS Catalina and later install to APFS (Apple File System). If your disk is formatted as Mac OS Extended (Journaled), the installer may fail or force a conversion. To verify the format:

1. Open Disk Utility.
2. Select your internal disk (the top-level entry, not the volume underneath).
3. Look at the format listed. It should say “APFS” or “APFS (Encrypted)”.

If it is not APFS, you can convert it during installation by erasing the disk. In Recovery Mode, select Disk Utility, choose the disk, click Erase, set the format to APFS, and name it. Then quit Disk Utility and choose Reinstall macOS. This wipes all data, so only do it if you have a backup or nothing to lose.

Reset NVRAM and SMC

Non-volatile RAM (NVRAM) stores certain settings that can affect startup and installation. Resetting it is harmless and sometimes clears stubborn installer errors.

• Intel Macs: Shut down, then turn on and immediately press and hold Option + Command + P + R for about 20 seconds. For SMC (System Management Controller), the steps vary by model; check Apple’s support page for your specific Mac.
• Apple Silicon (M1/M2/M3): NVRAM reset is not needed and not possible in the same way. Restarting your Mac generally clears the same kinds of settings.

After resetting, try the installation again.

Install in Safe Mode

Safe Mode loads only essential extensions and can prevent third-party software from interfering with the installation.

1. Shut down your Mac.
2. Turn it on and immediately press and hold the Shift key.
3. Release the key when you see the login window. The screen will say “Safe Boot” in the menu bar.
4. Once in Safe Mode, run the installer again.

If the installation succeeds in Safe Mode, the problem was likely a third-party kernel extension or startup item. After a successful install, you can restart normally.

Frequently Asked Questions

Will I lose my data if I reinstall macOS?
No, a standard reinstall over your current system preserves your files and apps. Only erasing the disk before reinstalling deletes everything. Always back up to Time Machine or another drive before attempting any repair.

How much free space do I need for macOS installation?
Apple recommends at least 20–30 GB for a major upgrade, but more is better. During installation, macOS creates temporary files and needs room to expand system snapshots. If you are low on space, delete large files or move them to an external drive.

Can I install an older macOS version if the new one fails?
Yes, you can download an older installer from the App Store or use a bootable USB. However, your Mac must be compatible with that version. If the hardware is newer, an older macOS may not support it.

Why does the installer fail at the “About 2 minutes remaining” stage?
This is often a sign of a corrupted installer or a disk that cannot be written to. Try re-downloading the installer and running First Aid on your disk. If it still fails, the drive may be failing.

Should I use a USB installer or the App Store version?
Both work. A USB installer is useful if your Mac cannot boot into Recovery Mode or if you want to install on multiple machines. The App Store version is simpler for a single Mac. If the App Store download keeps failing, a USB installer created with createinstallmedia is a reliable alternative.

Is there a way to see detailed logs of the installation failure?
Yes. While the installer is running, press Command + L to open the log viewer. You can also check the system log after a failure by opening Console and searching for “Install” or “OSInstaller”. Look for lines marked “error” or “failed” to identify the specific cause.

Related

• Fix Wi-Fi Keeps Disconnecting on Android
• Mac Display Brightness Not Working? Fixes That Work
• Netflix Not Working? Fix It Yourself