You clicked Upgrade Now, the installer downloaded, and then — nothing. A dialog tells you there is not enough space to install macOS Tahoe and the update stops cold. macOS 26 requires roughly 12–15 GB of free space to complete the upgrade, and on a 256 GB Mac that has been in daily use, that room can disappear fast. The steps below are ordered by how much space each one typically recovers, so you can work through them until the installer stops complaining.
Before You Start: Check How Much You Actually Need
Open Apple menu > System Settings > General > Storage. Note your available space and the breakdown by category. The Tahoe installer needs a contiguous working area — a common rule of thumb is at least 20 GB free before starting, even though the final install footprint is smaller. If you are short by only 2–3 GB, one or two of the steps below will be enough. If you are short by 10 GB or more, work through the list in order.
Important: Deleting files is permanent unless you have a backup. Before any cleanup session, confirm Time Machine or another backup is current.
1. Empty the Trash and Delete Large Downloads
This is the fastest no-risk step. Open Finder, press Command-Shift-Delete to empty the Trash, then check your Downloads folder (~/Downloads) for installers, disk images, and ZIP archives you no longer need. Old .dmg and .pkg files are common offenders and are completely safe to delete once the app is already installed.
Typical recovery: 1–5 GB
2. Remove Old iOS and iPadOS Device Backups
iTunes/Finder stores iPhone and iPad backups locally and they grow with every backup cycle. To delete them:
- Open Finder and connect your device (or go to Finder > Locations if the device is already listed).
- Click Manage Backups from the device summary page.
- Right-click any backup you no longer need and choose Delete Backup.
Backups live at ~/Library/Application Support/MobileSync/Backup/ — you can browse there in Finder (Go > Go to Folder) to see sizes before deleting through the UI.
Typical recovery: 2–20 GB per device
3. Clear System and App Caches (The Fast Way)
macOS accumulates cache files in two main locations: ~/Library/Caches (your user caches) and /Library/Caches (system-wide). Most of these are safe to delete — the app that created them will rebuild what it needs on next launch — but some caches regenerate immediately and are not worth the effort.
You can do this manually in Terminal:
# Clear user caches (safe; apps rebuild on demand)
rm -rf ~/Library/Caches/*
# Clear user logs
rm -rf ~/Library/Logs/*
If you prefer a visual approach, Crumb scans all of these locations — system caches, user caches, logs, temp files, and purgeable space — in one pass and shows you exactly what it found before removing anything. It is usually the fastest way to reclaim several GB without manually hunting through hidden Library folders.
Typical recovery: 2–8 GB
4. Delete Unused Applications
Dragging an app to the Trash only removes the app bundle. Most macOS apps leave behind preference files, support data, and caches scattered across ~/Library/Application Support/, ~/Library/Preferences/, and ~/Library/Containers/. For apps you are genuinely done with, those leftovers are wasted space.
To remove an app and its support files in one step, use the Uninstall tab in Crumb: it lists all installed apps, then when you select one, shows you the associated leftover files and lets you choose which to remove. This avoids the orphaned-files problem that a plain Trash-drag leaves behind.
If you prefer doing it manually, after moving the app to Trash, also check:
~/Library/Application Support/<AppName>~/Library/Containers/<bundle-id>~/Library/Preferences/com.<developer>.<app>.plist
Typical recovery: 1–10 GB depending on apps removed
5. Remove Old Xcode Derived Data and Simulators
If you develop for Apple platforms, Xcode's derived data and simulator runtimes are among the biggest disk consumers on any developer Mac.
# Delete derived data
rm -rf ~/Library/Developer/Xcode/DerivedData/*
# List simulator runtimes (check sizes first)
xcrun simctl runtime list
# Delete unused simulator runtimes via Xcode:
# Xcode > Settings > Platforms > select runtime > minus button
A single iOS simulator runtime can be 6–9 GB. If you do not test on older OS versions, removing them is safe — Xcode will re-download if you need them later.
Typical recovery: 5–30 GB for active developers
6. Clear Docker Images and Containers (If Installed)
Docker stores its images in a virtual disk that grows silently. If you use Docker Desktop:
# Remove stopped containers
docker container prune
# Remove unused images
docker image prune -a
# Remove unused volumes
docker volume prune
You can also open Docker Desktop and use the Images and Volumes tabs to delete visually. Only remove images you can re-pull; local-only images that took effort to build should be pushed to a registry first.
Typical recovery: 5–40 GB for Docker users
7. Remove Old Time Machine Local Snapshots
When your external Time Machine drive is not connected, macOS stores local snapshots on your startup disk. These count as "purgeable" and macOS should release them automatically when space is needed — but sometimes they hang around.
# List local snapshots
tmutil listlocalsnapshots /
# Delete a specific snapshot (replace the date string)
tmutil deletelocalsnapshots 2026-05-15-120000
You can delete all local snapshots at once if you are confident your off-disk backup is current:
tmutil deletelocalsnapshots /
Typical recovery: 2–15 GB
8. Optimize or Remove Large Media Files
Open the Storage panel again (System Settings > General > Storage) and look at the Media category. Large video exports, raw photo libraries, and music downloads often account for tens of GB. Options:
- Move large video files to an external drive before upgrading, then move them back.
- In Photos, enable Optimize Mac Storage (Photos > Settings > iCloud) to swap full-resolution originals for smaller previews.
- Check
~/Movies/for Final Cut or iMovie project renders — rendered proxies can be re-created and are safe to delete from the project's storage management panel.
Typical recovery: varies widely; often 10–50 GB
9. Move or Archive Your Largest Files Temporarily
If you have done all of the above and are still short, the pragmatic last step is to move large-but-needed files off the disk temporarily. Copy them to an external drive or upload them to cloud storage, run the Tahoe upgrade, then move them back.
To find your largest files quickly from Terminal:
# List files over 500 MB in your home folder
find ~ -size +500M -not -path "*/.*" 2>/dev/null | xargs du -sh | sort -rh | head -20
Typical recovery: however much you move out
Quick Reference: Space Recovery at a Glance
| Step | Safe to delete? | Typical recovery |
|---|---|---|
| Trash + Downloads | Yes | 1–5 GB |
| iOS device backups | Yes (if backed up elsewhere) | 2–20 GB |
| Caches and logs | Yes (rebuild on demand) | 2–8 GB |
| Unused apps + leftovers | Yes (apps you no longer need) | 1–10 GB |
| Xcode derived data / simulators | Yes (re-downloadable) | 5–30 GB |
| Docker images/volumes | Conditional (push first if local-only) | 5–40 GB |
| TM local snapshots | Yes (if off-disk backup is current) | 2–15 GB |
| Large media files | Move, do not delete | 10–50 GB |
| Temporary file move | Yes (restore after upgrade) | As needed |
After the Upgrade
Once macOS Tahoe finishes installing, it is worth running a second cleanup pass — the installer leaves behind its own temporary files and sometimes a copy of the previous system. Re-running the same cache and log cleanup steps (or a one-click scan with Crumb) usually recovers another 2–4 GB post-upgrade. Then re-import any files you moved to external storage and you are back to normal.