Not Enough Space to Install the macOS Update? Fix It Now

You clicked "Update Now," watched the progress bar fill — and then nothing. A dialog tells you there is not enough space to install the macOS update, and suddenly a routine upgrade becomes a frustrating puzzle. This guide explains exactly how much room the installer really needs, which files are safe to delete first, and how to reclaim purgeable space quickly so you can get back to updating.

How Much Space Does a macOS Update Actually Need?

Apple's stated storage requirement and the actual headroom the installer demands are often two different numbers. The installer needs space for the download, a temporary extraction area, and a safety snapshot — all at the same time.

Apple recommends a minimum of 20 GB free for a major upgrade, but if your drive is close to full that headroom may still not be enough once the installer stages its files. The practical target is 25 GB free before you start.

Check What Is Actually Using Your Space

Before deleting anything, get a clear picture. Open Apple menu → About This Mac → More Info → Storage Settings (or System Preferences → Storage on older macOS). You will see a colored bar broken down by category.

You can also run this in Terminal for a quick per-folder summary of your home directory:

du -sh ~/Library/* 2>/dev/null | sort -rh | head -20

And for system-level directories:

sudo du -sh /Library/Caches/* 2>/dev/null | sort -rh | head -10

Pay particular attention to System Data in Storage Settings — this category often hides gigabytes of purgeable space that macOS can reclaim but has not yet bothered to.

What Is Safe to Delete (and What Is Not)

Safe to clear

• User caches — ~/Library/Caches/. Apps rebuild these automatically. Deleting them may slow the first launch of an app, nothing more.
• System caches — /Library/Caches/. Same logic; macOS regenerates them as needed.
• User logs — ~/Library/Logs/. Historical log files from apps and crash reporters. Safe to remove.
• System logs — /var/log/ and /Library/Logs/. Cleared routinely by macOS itself; safe to remove manually.
• Temporary files — /private/tmp/ and /private/var/folders/. macOS clears /tmp on reboot; the per-user tmp folders are safe to clean.
• Purgeable space — APFS holds onto old Time Machine local snapshots and Optimized Storage placeholders as "purgeable." The installer can use some of this, but not always reliably.
• App downloads and installers — ~/Downloads/ is a common hidden gigabyte sink.
• Unused language packs inside app bundles (.lproj folders).
• Leftover app support files — data left behind by apps you already deleted.

Do NOT delete without understanding what it is

• ~/Library/Application Support/ — contains app databases, settings, and sometimes irreplaceable data (mail archives, game saves, creative project caches). Delete only specific sub-folders you recognise.
• /System/ and /usr/ — protected on modern macOS (System Integrity Protection), but do not attempt to modify them manually.
• Time Machine backup drive contents — never touch these on the backup volume itself.
• Virtual machine disk images unless you are certain you no longer need them.

Important: Cleaning is permanent. There is no Undo once you empty the Trash. If you are unsure about a folder, look it up before deleting it.

Step-by-Step: Free Up Space for the macOS Update

1. Empty the Trash. Open Finder, right-click the Trash icon in the Dock, and choose Empty Trash. Obvious, but often overlooked — deleted files still occupy space until the Trash is emptied.
2. Clear user caches manually. In Finder, press Cmd+Shift+G, type ~/Library/Caches, and delete the contents of folders you recognise (not the folders themselves, to avoid permission issues). Quit the relevant app first.
3. Delete old iOS/iPadOS device backups. In macOS Ventura and later: Finder → your iPhone in the sidebar → Manage Backups. Older backups can easily be 5–15 GB each.
4. Remove large files from Downloads. Sort ~/Downloads by size. Old disk images (.dmg), installer packages (.pkg), and video files are common space hogs.
5. Delete local Time Machine snapshots. macOS creates hourly local snapshots. You can list and remove them in Terminal:

   tmutil listlocalsnapshots /
   sudo tmutil deletelocalsnapshots YYYY-MM-DD-HHMMSS

   Replace the timestamp with the ones listed by the first command. Removing old local snapshots is safe — your main Time Machine backup on the external drive is unaffected.
6. Use Optimized Storage. Apple menu → About This Mac → More Info → Storage Settings → Optimize. This moves rarely accessed files to iCloud if you have space there and removes already-watched Apple TV purchases. It will not free space instantly, but can help over minutes.
7. Uninstall apps you no longer use — and make sure to remove their leftover files in ~/Library/Application Support/, ~/Library/Preferences/, and ~/Library/Caches/. A dragged-to-Trash uninstall leaves these behind.
8. Reboot, then retry the update. A reboot clears /private/tmp, flushes certain purgeable APFS space, and lets the installer start fresh.

The Faster Route: One-Click Cleanup

Manually hunting through cache folders and log directories works, but it is tedious and easy to miss things. Crumb is a native macOS menu-bar app that does all of the above in a single click — user caches, system caches, logs, temp files, and purgeable System Data — while showing you exactly how much each category contributes before you confirm anything. Its "Is this safe to delete?" AI can also explain any unfamiliar folder so you are never guessing.

If you want to skip the manual steps, download Crumb, run a Clean, and you will typically recover enough room for the update in under two minutes.

After Cleaning: Force macOS to Acknowledge the New Free Space

Sometimes the Software Update dialog caches its own storage check. After cleaning, do this before retrying:

1. Open Terminal and run purge to flush inactive memory (optional, but can help the OS update its storage accounting).
2. In Software Update, close and reopen System Settings (or System Preferences) entirely.
3. Click "Check for Updates" again rather than resuming the previous attempt.

If the update still refuses to proceed, verify your actual free space in Terminal:

df -h /

The "Available" column shows what the filesystem reports. If it matches what you expect but the installer still complains, try downloading the full installer from Apple's website and running it manually — the App Store delta updater sometimes has stricter space checks than the standalone package.

What About Purgeable Space?

APFS reports two numbers: available and purgeable. The installer can use purgeable space in theory, but this does not always happen reliably. To force macOS to convert purgeable space to genuinely free space, the most reliable method is to temporarily copy a large file (a multi-gigabyte dummy file) to your desktop — this forces APFS to purge what it was holding — then delete the dummy file. You can do this with:

dd if=/dev/zero of=~/Desktop/dummy.bin bs=1m count=10000
rm ~/Desktop/dummy.bin

This creates and immediately deletes a 10 GB file. APFS will purge old snapshots to accommodate the write, then the deletion returns the space. Use this only if Storage Settings shows a large "purgeable" figure that is not going away on its own.

Conclusion

A "not enough space" error during a macOS update is fixable in most cases without buying a larger drive. The key steps are: understand how much free space the installer genuinely needs (target 25 GB for major upgrades), clear the obvious sinks first (Trash, Downloads, device backups, local Time Machine snapshots), and do not delete anything you cannot identify. If you want to shortcut the manual process, Crumb's one-click Clean handles caches, logs, temp files, and purgeable System Data in one pass. Once you have the headroom, the update should proceed without complaint.