# Not enough space to update macOS? What to do

Guide · Updated 21 November 2026. By Mohit Nippanikar, who makes SiftMac.

## The short answer

- **Clear space in this order:** empty the Trash, remove old “Install macOS” apps and iPhone backups, move or delete big files, then clear caches. If the update still refuses, delete Time Machine’s local snapshots.
- **Why it asks for so much:** an update downloads, then unpacks and prepares itself on the same disk, so it needs more room than its download size. Some checks also ignore space macOS could free by itself.
- **Nothing changes until it fits.** The update just waits, and your files and current macOS stay as they are.

## 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](#snapshots) usually closes the gap. [What purgeable space is, and why it counts as available](https://siftmac.com/guides/purgeable-space-on-mac).

## 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](https://siftmac.com/safe-to-delete/macos-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](https://siftmac.com/guides/iphone-backups-on-mac).
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](https://siftmac.com/guides/find-large-files-on-mac).
5. **Used downloads:** installers and zip files for things you’ve already installed. [The Downloads folder](https://siftmac.com/safe-to-delete/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](https://siftmac.com/guides/how-to-clear-cache-on-mac).
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](https://siftmac.com/guides/developer-files-on-mac), [AI files](https://siftmac.com/guides/ai-files-on-mac).

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](https://siftmac.com/guides/time-machine-local-snapshots).

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](https://siftmac.com/guides/how-to-clear-cache-on-mac#system).

## 5. What not to do

- Don’t delete anything in `/System`, `/Library/Updates` or `/private/var/vm`. They hold macOS, the update itself, and the swap and sleep files, and macOS manages all three.
- Don’t run scripts or apps that promise to “clear System Data” by deleting system folders, and don’t turn off System Integrity Protection to make room.
- Don’t delete what you can’t get back just to fit an update, like the newest backup of a phone you use or your Photos library. Move what you can to an external drive instead; Apple describes [how to move the Photos library](https://siftmac.com/guides/photos-library-taking-up-space#move).

## 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:

- **Empty Trash Automatically**, in Storage settings, erases items that have been in the Trash for more than 30 days.
- **Software Update’s automatic options**, in System Settings › General › Software Update, decide whether updates download and install by themselves.
- **One backup per device.** Finder updates each device’s backup in place, so it’s backups of old phones and iPads that pile up.

## 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: https://siftmac.com/SiftMac.dmg (scanning is free, and so is the first 2 GB of cleaning).

## Sources

- [Apple: If an error occurred while updating or installing macOS](https://support.apple.com/en-us/102531)
- [Apple: Free up storage space on Mac](https://support.apple.com/en-us/102624)
- [Apple: About Time Machine local snapshots](https://support.apple.com/en-us/102154)
- [Apple: Start up your Mac in safe mode](https://support.apple.com/en-us/116946)
- [Apple: Update macOS on Mac](https://support.apple.com/en-us/108382)
- [Apple: Optimize storage space on your Mac](https://support.apple.com/guide/mac-help/optimize-storage-space-sysp4ee93ca4/mac)

## Related

- [What is purgeable space on a Mac?](https://siftmac.com/guides/purgeable-space-on-mac)
- [Is it safe to delete Time Machine local snapshots on a Mac?](https://siftmac.com/guides/time-machine-local-snapshots)
- [Can I delete old macOS installers and old versions of macOS?](https://siftmac.com/safe-to-delete/macos-installers)
- [How to clear System Data on a Mac, safely](https://siftmac.com/guides/system-data-on-mac)
- [System Data, explained: the parts SiftMac can name](https://siftmac.com/features/system-data)

Canonical: https://siftmac.com/guides/not-enough-space-to-update-macos
