macOS Update Stuck or Not Enough Space? What to Check

Apps & MaintenancePublished 11 min read

A macOS update that seems stuck is often still working: Apple says the Apple logo or progress bar can stay up much longer than a normal startup, move slowly and pause for long periods, so give it time on power before you interrupt it. An update that will not start because of space is a different problem, and the fix is to free room you can account for, then run Software Update again. Work out which one you have before you hold down the power button or start deleting folders.

Read the message before you free anything

Open System Settings › General › Software Update and look at what it actually says. Apple's page on installation errors lists several kinds of message: an error while downloading, preparing or installing, or a note that the software is damaged, could not be verified, failed to personalize, or needs to be reinstalled. Space is only one of the checks Apple lists, and its advice there is short: if the message says the Mac does not have enough storage space, free up storage space.

The other messages point elsewhere. A failed download or personalization step needs a stable internet connection, because the installer fetches firmware and other information specific to your Mac model. A previously downloaded installer reported as damaged or unverifiable should be deleted and downloaded again from Apple after repairing the startup disk. Clearing gigabytes will not fix either.

How much free space an update needs

Apple's current support pages do not publish one fixed figure for every update, and the amount differs between a point release and a major upgrade. The useful number is the one the installer reports on your Mac. Apple does note in its download and install guide that Software Update can use less storage space than other methods, so prefer it over downloading a full installer app unless you need one.

Two things in System Settings › General › Storage confuse the comparison:

  • Available is not the same as free. Apple's Storage settings guide defines available storage as free storage plus purgeable disk caches, and notes that space can be both available and used at the same time. A large purgeable figure is space macOS expects to reclaim on demand, not a folder you can clear. The purgeable space explainer goes through why Finder, Storage and df disagree.
  • Local Time Machine snapshots already count as available. Apple's snapshot article says your Mac counts their space as available, that they do not block downloading, copying or installing software, and that Time Machine deletes them as they age or as space is needed. They are rarely the reason an update refuses to start. If a real install still fails after the normal checks, Apple's manual route is to turn off automatic backups briefly and wait; the local snapshot guide covers that and what you give up.

You can check the raw figure in Terminal before and after each change:

df -h /

df -h prints binary units (Gi), so it reads a few percent lower than Storage settings' decimal GB.

What to free first

Start with large files you recognize and can get back. Apple's free up storage space article lists these, roughly in the order that tends to pay off:

  1. Downloads. Old disk images and packages pile up here. Once the app inside a .dmg has been copied to Applications and opens from there, the image is usually disposable; deleting DMG files covers the one exception, images that hold your own documents.
  2. Old macOS installers. A full installer downloaded earlier lands in the Applications folder as an app named Install followed by the version name. If it is for a release older than the one you are running, you no longer need it to update. Keep the one for the version you are about to install, and leave installer files alone while an update is downloading or preparing.
  3. iPhone and iPad backups. If you back up a device to this Mac, old backups can be large. Apple says you can delete old backups; deleting iPhone backups shows how to do it by device name in Finder rather than by digging in the folder.
  4. Media you can stream or download again, and apps you no longer use.
  5. The Trash. Apple notes that space from files moved to the Trash does not become available until you empty it.

Measure again with df -h / after each step. If you are still a few gigabytes short, Apple offers one more option on the same page: starting up in safe mode clears certain system caches, which can make enough room to complete a task that needs the space only while it runs, such as installing a macOS update. The caches are rebuilt as needed afterwards. For the broader case of a full disk, including what not to delete in System Data, see startup disk full.

What a normal update looks like

Software Update downloads and prepares the update, then restarts the Mac to install it. Apple does not publish how long each stage should take, so treat any time estimate on screen as a guide, not a deadline.

After the restart, Apple's article on the Apple logo or progress bar describes the normal pattern: the Apple logo or progress bar might persist for much longer than usual, the bar might move slowly and pause for long periods, and the screen can alternate with a blank screen several times. Apple's Update macOS page says the same about restarts and adds one instruction: let installation finish without putting the Mac to sleep or closing its lid. Apple even recommends starting an installation in the evening so it can run overnight if it needs to.

So before deciding it is stuck:

  • Connect a laptop to power. Apple's Software Update settings ask for the Mac to be turned on, connected to power and connected to the internet when an update installs overnight; the same holds for one you start by hand.
  • Keep the lid open and the Mac awake. Closing a MacBook lid during installation is exactly what Apple asks you not to do.
  • Check the network during download and preparation. If other devices on the same Wi-Fi are slow or offline, the update is waiting on the connection, not hung.
  • Give it hours, not minutes, if the progress bar has moved at all since you last looked.

When it really is stuck

If a download or preparation step in Software Update has not moved for a long time, or ends with an error, Apple notes that the cause varies and is sometimes only temporary. Check the internet connection and free space, restart the Mac normally, and open Software Update again.

If the Mac never gets past the Apple logo or progress bar, Apple's steps in the same startup article are:

  1. Press and hold the power button for up to 10 seconds until the Mac turns off, then turn it back on. On a laptop with Touch ID, hold Touch ID.
  2. If it is still stuck, turn it off again, unplug nonessential accessories such as printers, drives and USB hubs, then turn it on.
  3. If that does not help, start up from macOS Recovery and repair the startup disk with Disk Utility.
  4. If the problem persists, reinstall macOS from macOS Recovery. If it still starts to an Apple logo or progress bar after that, Apple says the Mac might need service.

Force a shutdown only after a long stall with no movement, not the moment a bar pauses.

Install from safe mode or macOS Recovery

When an update keeps failing for reasons other than space, Apple's error guidance suggests two ways to keep other software out of the way. If you install from Software Update, start up in safe mode first: safe mode stops login items and non-essential extensions from loading, checks the startup disk, and clears some system caches. On a Mac with Apple silicon, shut down, hold the power button until startup options load, select the startup disk, then hold Shift and click Continue in Safe Mode. On an Intel Mac, hold Shift as soon as the Mac starts until the login window appears. Then run Software Update from there.

The stronger option is installing from macOS Recovery. Apple's reinstall guide says that reinstalling macOS from Recovery does not remove your apps or personal data. Choose the reinstall option, select Macintosh HD if the installer offers both it and Macintosh HD - Data, and again let it finish without sleep or a closed lid. Recovery needs a broadband connection; Apple notes that captive-network logins and 802.1X security can prevent installation.

Erasing the Mac is last on Apple's list because it removes everything; it is not a fix for a slow progress bar.

Back up before you push further

Apple's Update macOS page says it is a good idea to back up your Mac before installing new software, and that applies twice over once an update has failed. Make one before a second forced restart, before First Aid on the startup disk, and before a Recovery reinstall. Apple's backup guide covers Time Machine to an external drive, iCloud, and copying files by hand. If the Mac still starts normally, back up then.

Once the update is installed, some background work continues, and a Mac can feel slow for a while. That is a separate problem with its own checks: see a Mac slow after a macOS update.

Where Mole fits

Mole does not install or repair macOS updates; it helps with the space question beforehand. Clean groups app caches, uninstalled-app leftovers, System Data items such as local Time Machine snapshots, system caches and logs, and old macOS installers, and Trash, and shows each row with its size for review before anything is removed. It does not offer /macOS Install Data while a Software Update is pending or an installer is running, and installer rows are never selected by default. iPhone and iPad backups appear under Manage Separately as read-only rows, outside the cleanup total.

For anything Clean does not list, Analyze draws a treemap of the whole disk so you can see which folder in Downloads or Movies is actually large, and Move to Trash keeps the item recoverable until you empty the Trash. If the startup disk is above 90% used, Mole's Doctor flags it, because macOS needs free space for swap, snapshots and updates; the Help page has the details.

FAQ

How long should a macOS update take?

Apple does not publish a fixed time. It says the Apple logo or progress bar can persist much longer than usual during an update and may pause for long periods, and it recommends starting in the evening so the install can finish overnight.

Is it safe to turn off my Mac during an update?

Only after a long stall with no progress. Apple's steps for a Mac stuck on the Apple logo or progress bar start with holding the power button for up to 10 seconds, then move to Disk Utility and a Recovery reinstall if the problem persists.

Why does my Mac say there is not enough space when Storage shows plenty available?

Available storage includes purgeable caches and local snapshots that macOS reclaims on demand, so the figures do not always line up with what a task can use at that moment. Free some space you control, such as old installers, downloads or device backups, check df -h /, and try again.

Will reinstalling macOS from Recovery delete my files?

Apple says reinstalling macOS from macOS Recovery does not remove your apps or personal data. Back up first anyway, and do not choose to erase the disk unless every other step has failed.