“Your startup disk is almost full”: what to actually do
The 'startup disk almost full' warning on your Mac isn't just a nag; APFS needs real free headroom. Here's what triggers it and how to clear room safely.
Your Mac just threw up a dialog: "Your startup disk is almost full." It's easy to dismiss and forget, until apps refuse to save and a macOS update won't install. The "startup disk almost full" warning on a Mac is worth acting on, but not worth panicking over. Here's what actually triggers it and the safe order to clear room fast.
What triggers the "startup disk almost full" warning
Your startup disk is the volume macOS boots from: the one holding the system, your apps, and your home folder. The alert fires when free space on that volume drops low enough that macOS thinks it may soon be unable to work normally: save files, index Spotlight, download updates, take snapshots.
Apple doesn't publish an exact percentage or gigabyte figure that sets it off. The often-repeated "macOS needs at least 10% free" figure is third-party rule-of-thumb guidance, not an Apple spec. Fine as a rough gut check, but don't treat it as a hard line.
Why it matters beyond the annoyance
A too-full startup disk isn't just inconvenient. It's a genuine risk to how the drive works. APFS (the Mac filesystem) and the SSD underneath it need working headroom for everyday filesystem operations, SSD wear leveling, and the SLC write cache that keeps writes fast. Starve them and performance drops; in the worst case a Mac can, in the words of macOS-internals expert Howard Oakley, "seize up altogether" and need a wipe-and-restore.
So the number to aim for isn't a vague percentage. Oakley's guidance is concrete: keep an absolute minimum of 50 GB free on your startup volume, and preferably well over 100 GB. That's the headroom that keeps APFS and the SSD healthy. Treat it as your real target, not the point where the warning happens to appear.
What macOS already does on its own
Before you delete anything, know that macOS is already fighting the same fight. When space gets tight it:
- Reclaims purgeable space: it removes caches, logs, temporary database files, interrupted downloads, staged system and app updates, and Safari website data it considers safe to delete. You can't trigger this by hand; macOS does it on demand.
- Thins local snapshots: Time Machine's hourly local APFS snapshots are normally kept about 24 hours, and macOS deletes older ones first when the disk runs low.
- Clears rebuildable system caches in Safe Mode: booting into Safe Mode clears certain system caches, which macOS then recreates automatically, sometimes freeing just enough room to finish a stuck task like an OS update.
This is why frantically scrubbing cache folders by hand is mostly pointless. The system reclaims that class of junk itself. The space you actually control is the big, visible stuff: files, media, backups, and apps.
Clear room fast: the safe order
Work top-down; safest and quickest first. Start in Apple menu → System Settings → General → Storage, read the usage bar and the Recommendations, then:
- Empty the Trash. Deleted files don't free space until the Trash is emptied.
- Clear out Downloads. Old
.dmgand.pkginstallers are disposable once the app is installed. - Offload photos and videos. Video is the real space hog. Move a large library to an external drive, or turn on iCloud Photos "Optimize Mac Storage."
- Delete old iPhone and iPad backups. These sit on your Mac and can run to tens of GB each, often the single biggest quick win. Keep your most recent backup.
- Uninstall large apps you don't use, properly, so their leftover support files go too, not just the app icon.
Each of these deserves its own careful walk-through. For the full step-by-step, see how to free up space on a Mac, and before you remove anything you're unsure about, check what's safe to delete. If you're wondering why the disk filled up in the first place, especially where "System Data" and other invisible space come from, see why your Mac's storage is full.
The tedious part isn't knowing the order. It's finding the biggest safe wins without trashing something you need, and then trusting a cleaner's "freed" number. Plumby measures what it actually removes, shows the exact path of everything it proposes to move, and acts only on your command, so you clear real gigabytes fast, and never the documents, photos, or projects you meant to keep.
