Mac storage full — core guides

MacBook Says "Your Disk Is Almost Full"? Here's Exactly What to Do (2026)

The moment your Mac throws up the "Your disk is almost full" warning, your machine is already struggling — app launches slow down, Time Machine pauses, and some apps start refusing to save files. The good news is that macOS accumulates a predictable set of clutter, and most of it is safe to remove in a specific order. This guide walks you through triage: what triggered the alert, what to delete first, and what to leave alone.

Why Does the "Your Disk Is Almost Full" Warning Appear?

macOS shows the disk-almost-full Mac warning when your startup volume drops below roughly 10–15 GB of free space (the exact threshold varies by macOS version). At that point the system can no longer manage virtual memory, Spotlight indexing, or Time Machine local snapshots gracefully. Things break quietly at first — autosave fails, Final Cut Pro drops frames, Xcode refuses to build — and then loudly.

The warning does not mean your disk is broken. It means you have accumulated more data than the drive can comfortably hold while still letting the OS breathe. The fix is almost always reclaiming space, not buying a new Mac.

Step 1: Find Out What Is Actually Eating Your Space

Before deleting anything, get a clear picture. Apple's built-in storage breakdown is a good starting point.

  1. Open Apple menu > System Settings (or System Preferences on macOS Monterey) > General > Storage.
  2. Wait for the bar to finish calculating — each coloured segment represents a category.
  3. Click the i icon next to any category for a breakdown.

The built-in view groups things broadly. For a file-level map — which specific folders and files are largest — a disk visualiser gives a much clearer picture. Crumb includes a whole-Mac audit that lists your largest items and shows a zoomable disk map, which is often the fastest way to spot a 20 GB virtual machine image you forgot about or a Downloads folder that ballooned over the years.

Step 2: The Fastest Wins (Safe to Delete)

These categories are safe to clear without affecting your documents or apps.

System Caches

macOS and every app you run writes cache files to ~/Library/Caches and /Library/Caches. These are rebuilt automatically — removing them costs you nothing except a slightly slower first launch after cleaning.

# See how large your user cache folder is
du -sh ~/Library/Caches

You can delete the contents of ~/Library/Caches manually (not the folder itself), but be aware some apps keep lock files there that they expect to be present. A safer approach is to let a cleaner handle the subset it knows is safe.

Logs

System and app logs live at ~/Library/Logs and /var/log. Unless you are actively debugging a crash, these serve no day-to-day purpose and can be deleted freely.

Temporary Files

The OS manages /private/tmp and /var/folders/… automatically, but these directories often hold gigabytes of orphaned installer files, Xcode derived data, and app temp files that survive reboots longer than they should.

Purgeable Space

macOS marks some data as "purgeable" — iCloud-offloaded files, optimised storage placeholders, and APFS snapshots. Finder counts this as used space even though macOS will reclaim it under pressure. If the Storage pane shows a large "Purgeable" segment, you can force-reclaim it:

# Force macOS to purge APFS snapshots and purgeable space
tmutil deletelocalsnapshots /

Run this in Terminal; it is safe and reversible only in the sense that Time Machine will create new snapshots going forward.

If you want to do all of the above in one click, download Crumb — its Clean tab handles system caches, logs, temp files, and purgeable space together and shows you exactly how much each category contributes before you confirm.

Step 3: Large Files and Downloads (Review Before Deleting)

After clearing obvious clutter, the next biggest wins usually come from:

  • Downloads folder — installers, zip archives, and disk images accumulate fast. Sort by size and remove anything you no longer need.
  • Virtual machines — Parallels, VMware, and UTM images typically run 20–80 GB each. If you are not actively using one, move it to an external drive.
  • Old iOS/iPadOS device backups — stored in ~/Library/Application Support/MobileSync/Backup/. Manage these in Finder: Window > Devices and delete backups for devices you no longer own.
  • Xcode derived data and simulators~/Library/Developer/Xcode/DerivedData and simulator runtimes can consume 30–50 GB for active developers. Delete derived data freely; re-download simulators only if needed.
# Remove all Xcode derived data (safe to delete, rebuilds on next build)
rm -rf ~/Library/Developer/Xcode/DerivedData

Step 4: Uninstall Apps You No Longer Use

Dragging an app to the Trash only removes the app bundle. Most apps scatter support files, caches, and preferences across four or five Library locations — none of which move when you drag the icon.

Location What lives there Risk if deleted
~/Library/Application Support/AppName User data, databases, settings Low (if app is gone)
~/Library/Caches/com.developer.AppName Rebuild caches None
~/Library/Preferences/com.developer.AppName.plist App preferences None (if app is gone)
/Library/Application Support/AppName System-wide helpers, daemons Low-medium; daemons stop

Crumb's Uninstall tab finds apps alongside their leftover files and lists them for review before anything is removed — useful when you want confidence that you are getting the full footprint, not just the app bundle.

Step 5: What Not to Delete

A few areas that look like junk but are not:

  • ~/Library/Application Support/ for apps you still use — this is live user data (think Notion's local database, Reeder's feed cache). Deleting it means losing settings or local content.
  • /System/ and /usr/ — protected by System Integrity Protection on macOS 11 and later; you generally cannot delete these even by accident.
  • Time Machine backups on your startup disk — local snapshots are managed by the OS. Delete them with tmutil deletelocalsnapshots rather than navigating to the hidden backup directory manually.
  • Anything you are unsure about — the AI in Crumb's command bar can explain what a specific folder is and whether removing it is safe, which is handy for unfamiliar paths in /Library.

Staying Ahead of the Warning

Once you have recovered space, a few habits keep the disk-almost-full Mac warning from returning:

  • Clear your Downloads folder monthly — set a calendar reminder.
  • Enable Optimise Mac Storage in iCloud settings if you have iCloud Drive, so large files offload automatically.
  • Review your largest files quarterly using either the built-in Storage view or a disk visualiser.
  • Uninstall apps completely rather than dragging them to the Trash.

Summary

The macbook disk full message is alarming but fixable in most cases within 15–20 minutes. Start with the guaranteed-safe wins — caches, logs, temp files, and purgeable space — then work through large files and unused apps. Be deliberate about anything in your Application Support directories, and skip anything you cannot identify with confidence. A focused cleanup pass now buys months of headroom before the warning reappears.

Reclaim your disk in one click

Crumb audits your whole Mac, tells you what's safe to delete, and frees the space in seconds — private, local, and Apple-notarized.

Download Crumb for macOS

Frequently asked questions

How much free space does macOS need to run properly?
Apple recommends keeping at least 10–15 GB free on your startup volume. Below that, virtual memory, Spotlight indexing, and Time Machine local snapshots start to fail, which causes slowdowns and save errors.
Is it safe to delete everything in ~/Library/Caches?
The contents of ~/Library/Caches are generally safe to delete — apps rebuild them automatically. Avoid deleting the folder itself, and be aware that a few apps store lock files there that they recreate on next launch.
Why does macOS show 'purgeable' space as used?
Purgeable space includes iCloud-offloaded file placeholders and APFS snapshots that macOS has marked safe to reclaim under pressure. Finder counts it as used because it is still allocated. You can force-reclaim it by running `tmutil deletelocalsnapshots /` in Terminal.
Does dragging an app to the Trash free all its disk space?
No. Dragging an app to the Trash removes only the app bundle. Support files, caches, preferences, and launch agents are left behind in various Library locations and must be removed separately.
What is the fastest way to respond to the 'your disk is almost full' warning?
The quickest first step is clearing system caches, logs, temporary files, and purgeable space — categories that are safe to remove without reviewing individual files. After that, look for large files in your Downloads folder and consider uninstalling apps you no longer use along with their leftover files.