SiftMac
Guide · Updated 21 November 2026

Not enough space to update macOS? What to do

By Mohit Nippanikar, who makes SiftMac

The short answer
On this page
  1. Find out how much it needs
  2. Check the real free space
  3. What to clear first
  4. If it still says there isn’t enough space
  5. What not to do
  6. Keep room for the next one
  7. Questions

1. Find out how much it needs

The message from Software Update usually says how much more space it wants. Write that number down: it’s your target. To see each available update and its download size in Terminal (this only lists, it installs nothing):

softwareupdate --list

Sizes there are in KiB: divide by about a million for GB, so 3,000,000 KiB is roughly 3 GB. That’s the download. Installing needs room on top of it to unpack and prepare the update, which is why the message asks for more.

2. Check the real free space

Finder and Storage settings can say there’s plenty while the installer says there isn’t. They count purgeable space, such as Time Machine’s local snapshots and iCloud files macOS can download again, as available; an installer may count only what’s free right now. This shows that figure:

df -h /System/Volumes/Data

Avail is what’s free at this moment. If it’s far below what Finder shows, the difference is purgeable space, and deleting the snapshots usually closes the gap. What purgeable space is, and why it counts as available.

3. What to clear first

In order of space gained for the least risk. Run df -h /System/Volumes/Data after each step, and stop once you’re comfortably past the target.

  1. Empty the Trash (Finder › Empty Trash), and Photos’ Recently Deleted album (Delete All). Both keep their space until they’re emptied.
  2. Old macOS installers. An “Install macOS …” app in Applications is a full installer of many gigabytes. If it’s for the version you already run, or an older one, drag it to the Trash. If it’s the upgrade you’re trying to install, keep it. More on installers.
  3. iPhone and iPad backups and update files. Storage settings › iOS Files › ⓘ lists them. The iOS software files can go, since Finder downloads them again; for backups, keep the newest of each device you use. Which to keep.
  4. Big files you can move. Videos, disk images and finished projects can go to an external drive for now and come back after the update. Find them.
  5. Used downloads: installers and zip files for things you’ve already installed. The Downloads folder.
  6. Caches, with their apps quit. They rebuild, so they buy room for the update rather than for good. How to clear them.
  7. Developer and AI files, if you have them. Xcode build data, simulators, Docker images and local models are often the biggest things on a Mac. Developer files, AI files.

Then restart. It clears swap files and temporary files, and Storage settings counts again from scratch.

4. If it still says there isn’t enough space

Delete Time Machine’s local snapshots. Apple says Time Machine saves one about every hour and keeps it for 24 hours, and that the Mac counts their space as available, yet they hold on to everything you just deleted. Removing them doesn’t touch the backups on your Time Machine drive:

tmutil listlocalsnapshots /
sudo tmutil deletelocalsnapshots /

The first line lists them. The second removes every local snapshot of the startup disk, and asks for your password. Apple’s own way is to set Time Machine’s backup frequency to Manually for a few minutes, then back to automatic. When deleting snapshots is worth it.

Still stuck? Start up in safe mode and run Software Update from there. Apple suggests installing in safe mode so other software can’t interfere, and safe mode also clears some system caches, which can free a little extra space for the moment. How to start in safe mode.

5. What not to do

6. Keep room for the next one

Smaller updates arrive several times a year, and the big yearly upgrade needs the most room, so a margin of free space saves a scramble each time. Three settings help:

Questions

Why does the update need more space than its download size?

It downloads first, then unpacks and prepares the new system on the same disk before it restarts to install. If Time Machine is on, macOS also saves a local snapshot just before installing any update, as Apple describes. So clear a little more than the message asks for.

I freed up space, so why does it still refuse?

Usually the Trash isn’t empty yet, local snapshots still hold the files you deleted, or Software Update hasn’t checked again. Empty the Trash, delete the snapshots, restart, and check df -h /System/Volumes/Data before you try again.

Will deleting local snapshots delete my Time Machine backups?

No. The backups on your Time Machine drive stay as they are. Only the copies kept on the Mac itself go, and Time Machine starts making new ones about every hour.

Is it safe to delete an “Install macOS” app?

Yes, if it’s for the version you already run or an older one: it’s only an installer, and you can download it again from Apple. Keep one for a newer version until you’ve upgraded, unless you’d rather download it again later.

How SiftMac handles it. Its System Data view lists the parts that usually block an update: old “Install macOS” apps (one for the version you run, or older, is marked Rebuilds; one for a newer macOS is yours to decide), iPhone and iPad backups with the newest of each device marked, iOS update files, and the space macOS frees by itself, with how many local snapshots there are, left to macOS. Backups and other files you remove wait on the Undo Shelf, which is on the same disk, so when the update needs the room today, use Free now on the shelf.

Download SiftMac · scanning is free, and so is your first 2 GB of cleaning · See how it works