Your startup disk is almost full: what to do when a Mac has no space left
"Your disk is almost full" appears, apps start to stall, and an update refuses to install. A Mac needs free space to work at all, so this is worth fixing the same day. Go through these seven places in order. The first ones take a minute each and often free enough to get the Mac working again; the later ones find the space that Finder does not show.
1. See where the space went
Open System Settings, General, Storage and wait for the coloured bar to finish calculating. The list under it shows each category with its size. Click the small i next to a category to see its largest items. Note the two or three biggest categories; they decide which steps below matter for you.
2. Empty the Trash, and the other Trashes
Files in the Trash still take space. Empty it from the Finder menu. Photos has its own Recently Deleted album and Mail has its own Trash mailbox; both keep items for about a month unless you empty them by hand.
3. Downloads and large files
The Downloads folder collects installers and videos for years. Open it in Finder, switch to list view and sort by size. To find large files anywhere, press Command-F in a Finder window, choose File Size as the search condition and look for files larger than 1 GB.
- Disk images (.dmg) and installers (.pkg) can go once the app is installed.
- "Install macOS" apps in the Applications folder are 12 GB or more each and are only needed during an update.
4. Old iPhone and iPad backups
A backup made to the Mac years ago can hold tens of gigabytes. In System Settings, General, Storage, click the i next to iOS Files to see every backup with its size and date. Delete the backups of devices you no longer own, and old backups of the ones you do.
5. Photos, Messages and Mail
- Photos: with iCloud Photos on, choose Photos, Settings, iCloud, Optimise Mac Storage. Full-size originals move to iCloud and small versions stay on the Mac.
- Messages: years of received videos live inside the Messages data. In Storage, open Messages and delete the largest attachments.
- Mail: attachments are downloaded for every account. In Mail, Settings, Accounts, set Download Attachments to Recent.
6. Time Machine snapshots hidden in System Data
When the backup drive is not connected, Time Machine keeps local snapshots on the startup disk. macOS removes them when space runs short, but not always fast enough. List them in Terminal:
tmutil listlocalsnapshots /
To remove one, copy its date from the list:
tmutil deletelocalsnapshots 2026-11-14-093012
Connecting the backup drive and letting a backup finish clears them as well.
7. Developer files and caches
If you build apps on this Mac, most of System Data is Xcode build folders, simulators and package caches. That is a subject of its own, with the exact folders and commands, in our guide to freeing disk space on a developer Mac. Free My Disk is our macOS app that scans those locations, shows the size of each category and removes what you tick.
Read: free up disk space on a developer Mac
After cleaning
- Restart the Mac. Temporary files and swap space are released at restart, and the Storage bar is recalculated.
- Aim for at least 10 to 15% of the disk free. Below that, updates fail and the Mac slows down because it has no room for swap.
- If the disk fills again within days, look at step 1 once more: one category will have grown, and that names the cause.
Do not delete anything inside the System or Library folders by hand unless a step here names it. Space won back from the wrong folder is paid for with an app that no longer opens.