Home › Mac Guides › Startup Disk Full
“Your startup disk is almost full” — how to fix it properly
The warning usually arrives at the worst moment: mid-export, mid-update, mid-deadline. macOS needs free space to breathe — for swap, for temporary files, for updates — and once you drop below roughly 10% of your volume, performance degrades and apps start failing to save. Here is the sequence that gets space back fastest, ordered by how much each step typically returns.
Updated 2026-08-02 · Written by the CleanerMac team · macOS 13–15 tested
First, get an accurate picture
Before deleting anything, find out what you are actually dealing with. Open Terminal and run df -h /. Look at the Avail column — that is the truth. The Storage pane in System Settings caches its figures and often disagrees.
Then run du -sh ~/* | sort -h and du -sh ~/Library/* | sort -h. Between them, these two commands identify the cause on most Macs in under two minutes. Ignore the permission-denied lines; they are expected.
Finally, open Apple menu → System Settings → General → Storage for the category breakdown and Apple's own built-in recommendations (Store in iCloud, Optimise Storage, Empty Trash Automatically, Review Files). Those four are genuinely useful and cost nothing.
Step 1 — Thin Time Machine local snapshots
This is the highest-yield step and the one most people have never heard of. When your Time Machine drive is not connected, macOS still takes hourly backups and stores them as APFS snapshots on your startup disk. They accumulate silently.
See what you have: tmutil listlocalsnapshots /
Reclaim it: sudo tmutil thinlocalsnapshots / 999999999999 4
The large number is a byte target — effectively “as much as possible” — and 4 is the highest urgency level, which tells macOS to delete rather than defer. Your real backups on the external drive are completely unaffected. Re-run df -h / afterwards to see the change.
Step 2 — Empty the Trash, including per-app Trash
Obvious but frequently skipped. Also check inside Photos (recently deleted keeps items for 30 days), Mail (Trash mailbox), and any app with its own bin. In Photos: select Recently Deleted in the sidebar, unlock it, then choose Delete All.
Step 3 — Delete old iOS and iPadOS backups
Look in ~/Library/Application Support/MobileSync/Backup. Each subfolder is one device backup and can easily exceed 20 GB. Check modification dates to identify old ones. You can also manage them through Finder with the device connected, or via Apple menu → System Settings → General → Storage → iOS Files.
Step 4 — Clear caches
Quit the app first, then empty the contents of its folder inside ~/Library/Caches — not the folder itself. Browser caches are usually the largest; each browser also has a built-in Clear Browsing Data option that is safer than deleting files by hand. Our full walkthrough is at how to clear cache on Mac.
Step 5 — Hunt down large files
Use Finder's search: Command-F, then set the criteria to File Size is greater than 1 GB, and change the scope to This Mac. Or in Terminal, find ~ -type f -size +1G 2>/dev/null. Video files, virtual machine images, old project archives and forgotten downloads dominate this list. Our guide on finding large files on Mac goes deeper, including how to catch files you have not opened in a year.
Step 6 — Uninstall apps properly
Dragging an app to the Trash removes the bundle and leaves its caches, containers, preferences and Application Support data behind — sometimes gigabytes per app. Do it properly using our guide to uninstalling apps on Mac, and be especially thorough with Adobe apps, Docker, Xcode and anything that shipped its own installer.
How much space each step typically returns
| Step | Effort | Reversible? | Worth doing first? |
|---|---|---|---|
| Thin local snapshots | One command | No, but harmless | Yes — start here |
| Empty Trash | Seconds | No | Yes |
| Old iOS backups | A few minutes | No | Yes if you own an iPhone |
| Caches | A few minutes | Regenerates | Yes |
| Large files | Varies | Via Trash | Yes |
| App leftovers | Slow by hand | Via Trash | After the above |
| Duplicates | Slow by hand | Via Trash | Last |
Emergency measures when you cannot even boot properly
If the disk is so full that macOS will not let you log in normally or apps refuse to launch:
- Boot into Safe Mode (Apple silicon: hold the power button until startup options appear, select your disk, hold Shift and click Continue in Safe Mode). Safe Mode clears some system caches automatically.
- From there, run the snapshot thinning command in Terminal — it works in Safe Mode and needs almost no free space to operate.
- If you cannot log in at all, boot to Recovery, open Terminal from the Utilities menu, and run
tmutil thinlocalsnapshots /Volumes/<your data volume> 999999999999 4against the data volume (check its exact name withls /Volumes) — runls /Volumesfirst and substitute your volume's real name, since it is only “Macintosh HD - Data” on a default install. - As a last resort, move large personal folders to an external drive to get back above the threshold, then clean up properly once the system is usable.
Stopping it from happening again
Keep at least 10–15% of the volume free as a working target. Connect your Time Machine drive regularly so snapshots flush instead of accumulating. Turn on Empty Trash Automatically in the Storage settings. Enable Optimise Mac Storage for Photos if you use iCloud Photos. Clear Downloads as a monthly habit. And if your Mac has also started feeling sluggish, a full disk is a common cause — see how to speed up a slow Mac.
For people who would rather not repeat this sequence by hand every few months, CleanerMac automates the whole pass: it finds the snapshots, caches, backups, large files and app leftovers in one scan, explains what each item is, and routes deletions of your own files through the Trash so those decisions can be undone. One purchase, no subscription, and nothing leaves your Mac.
Get back above the line — today
CleanerMac finds the space a full disk is hiding from you.
Download CleanerMac — free for 3 daysmacOS 13+ · Apple Silicon & Intel · $24.99 once, no subscription
Frequently asked questions
How much free space should a Mac startup disk have?
Aim to keep at least 10–15% of the volume free. macOS uses that headroom for virtual memory swap, temporary files and updates. Below about 5% you will see failed saves, sluggish performance and blocked system updates.
Why does my Mac say the startup disk is full when Finder shows free space?
Finder and the Storage pane often report purgeable space as available even though it is not yet released. Run df -h / in Terminal for the real figure, and thin any APFS snapshots that are holding onto deleted blocks.
What is the fastest way to free space on a full Mac?
Thin Time Machine local snapshots with tmutil, then empty the Trash, then delete old iOS device backups. On a typical Mac those three steps take under five minutes and return more space than anything else you can do quickly.
Can a full startup disk damage my Mac?
It will not damage the hardware, but it can cause data loss through failed saves and can prevent macOS updates from installing. A severely full disk can also stop the system booting normally, which is why it is worth acting on the first warning.
Is it safe to delete files from ~/Library?
Contents of Caches and Logs are safe once the relevant app is quit. Do not delete Keychains, Preferences plists or Containers wholesale, and always remove the contents of a subfolder rather than the folder itself so apps can rebuild what they need.
Does moving files to iCloud actually free local space?
Only if Optimise Mac Storage is on and macOS chooses to evict the local copies. Files still shown with no download icon are still taking up disk space. Check the real free space with df -h after enabling it, not immediately.