A macOS update that hangs, fails partway through, or refuses to install at all is a common source of frustration, particularly on Macs that are due a major version upgrade rather than a small point release. This guide covers the most frequent failure messages and stuck states, why they happen, and the correct order to work through fixes without risking your data.

Pro tip: Before starting any major macOS update, especially a full version upgrade (like moving between macOS versions rather than a minor point update), back up with Time Machine first. Most update failures are recoverable without data loss, but having a current backup removes all risk from the process.

Step 1: Check the Basics Before Troubleshooting

Many update failures trace back to one of three simple causes, so rule these out first:

  1. Storage space. Major macOS updates typically need 20–45GB of free space temporarily during installation, even though the final installed size is smaller. Check available space via Apple menu > About This Mac > Storage, and free up space if it's below around 50GB free.
  2. Power connection. On a MacBook, always connect the charger before starting a major update — installation can be interrupted or refuse to proceed on battery power alone below a certain charge threshold.
  3. Stable internet connection. Large downloads over unstable Wi-Fi frequently corrupt partway through. If possible, use a wired Ethernet connection (via a USB-C adapter) for major updates.

"Not Enough Free Space" Errors

If macOS reports insufficient storage even after checking About This Mac > Storage, note that the on-screen estimate during the update process itself is often more accurate and higher than what Storage reports, since it accounts for temporary installer files.

  1. Empty the Trash fully — right-click the Trash icon in the Dock and select Empty Trash, since deleted files aren't actually freed until this step.
  2. Check Storage > Manage… for large "Other" or "System Data" categories, which often include old iOS backups, unused language files, or cached data that can be safely cleared.
  3. Uninstall large unused applications via Finder > Applications, dragging them to the Trash and then emptying it.
  4. If you use iCloud Photos or iCloud Drive with Optimise Mac Storage enabled, allow some time for locally cached files to be offloaded automatically, or manually review large local files in Photos.

Update Downloads but Fails to Install or Verify

Errors like "macOS could not be installed," "An error occurred while installing," or a failure during the "Preparing" stage usually point to a corrupted download or a conflict with the installer cache.

  1. Open System Settings > General > Software Update.
  2. If an installer icon for the update exists in Applications, drag it to the Trash and empty the Trash to remove the potentially corrupted download.
  3. Restart the Mac, then return to Software Update and download the update again from scratch.
  4. If it fails again at the same point, restart into Safe Mode first (on Apple Silicon Macs, shut down, then press and hold the power button until "Loading startup options" appears, select your drive, then hold Shift and click Continue in Safe Mode; on Intel Macs, restart and hold Shift immediately after the startup sound or Apple logo), which clears certain system caches, then restart normally and retry the update.

The Progress Bar Freezes or Barely Moves

A stuck progress bar during installation (as opposed to downloading) is unnerving, but these installs are more resilient than they appear and often just need more time than expected, particularly on Macs with mechanical hard drives or lower-spec Apple Silicon models with large downloads to unpack.

  1. Leave it for at least 45–60 minutes on a stuck-looking bar before assuming it has actually failed, especially if the estimated time remaining is fluctuating rather than frozen completely at a fixed percentage with no other activity.
  2. Check for any disk or fan activity as a sign it's still working (a spinning hard drive will produce faint clicking or humming; fans running indicates active processing) rather than judging solely by the visual progress bar.
  3. If truly frozen for over 90 minutes with zero activity, force a restart by holding the power button for 10 seconds, then attempt to boot normally — most of the time this either completes the pending install on the next boot or returns you to the previous working state, since Apple's installer is designed to be resumable.

Safety warning: Only force-restart during a stuck update as a genuine last resort after confirming there's truly no disk activity. Interrupting an install that's actually still writing system files can, in rare cases, require a full reinstall via Recovery Mode to fix.

"This Copy of the Installer Is Damaged" or Verification Failures

This error typically means the downloaded installer package is incomplete or was corrupted, often due to an interrupted download.

  1. Delete the installer from Applications and empty the Trash.
  2. Reset the network connection — switch from Wi-Fi to Ethernet if possible, or try a different network entirely, since some public or restrictive networks interfere with Apple's update servers.
  3. Check the date and time are correct in System Settings > General > Date & Time, with Set time and date automatically enabled — an incorrect system clock can cause macOS to fail certificate verification checks against Apple's servers, producing exactly this kind of error.
  4. Re-download the update via Software Update rather than reusing any previously downloaded installer file.

Update Fails Specifically on Apple Silicon Macs

Apple Silicon Macs (M1 and later) use a distinct recovery approach when standard troubleshooting doesn't work.

  1. Shut down completely, then press and hold the power button until "Loading startup options" appears.
  2. Click Options, then Continue, to enter Recovery Mode.
  3. From the Utilities menu (or the main recovery screen), select Reinstall macOS [version name].
  4. Follow the prompts — this reinstalls macOS over the existing system while preserving personal files and applications, similar in spirit to a Windows repair install.

Update Fails on Intel Macs via Internet Recovery

  1. Shut down, then power on while holding Command + Option + R (or Shift + Option + Command + R to install the version that originally shipped with the Mac, useful if the current update path itself is the problem).
  2. This boots into Internet Recovery, downloading a fresh copy of the recovery tools directly from Apple's servers rather than using the local disk, bypassing a potentially corrupted local recovery partition.
  3. From Utilities, choose Reinstall macOS and follow the prompts.

When to Seek Further Help

If reinstalling via Recovery Mode still fails, or Disk Utility (accessible from the same Recovery Mode menu, under Utilities > Disk Utility) reports errors when you run First Aid on the main volume, the underlying drive itself may be failing rather than the update process being at fault. In that case, prioritise backing up any accessible data immediately and consider a drive health check — see our guide on the best free tools to check drive health — before spending further time on update troubleshooting.

Was this guide helpful? Explore more Windows & macOS Tweaks guides, or browse all Operating System & Software articles.