Coffee
← Blog Mac Productivity

Your Startup Disk Is Almost Full: How to Fix It Now

By FavTray ·

Written by the team behind FavTray, a Mac developer dashboard for the menu bar. We check every app we cover against its own site, docs or a hands-on test, and each post says which.

Short answer: save your work, then empty the Trash, delete old installers from Downloads, and remove large files you recognise from System Settings › General › Storage › Documents. Restart. If you need room for a macOS update, start up in safe mode once to clear system caches. Don’t delete anything in /System, ~/Library or an app’s library to get there faster.

TL;DR

  • First two minutes: save open work, quit apps you don’t need, empty the Trash.
  • Next ten: Downloads, large files, apps you don’t use. All visible, all safe.
  • Then: restart, and safe mode once if you need room for an update.
  • Don’t panic-delete system folders, ~/Library, Photos or Docker data.
  • Afterwards, find what filled the disk so it doesn’t happen again.

What does “your startup disk is almost full” mean?

Your startup disk is the internal drive your Mac runs from, normally called Macintosh HD. The warning (the exact wording varies with your macOS version) means it’s close to having no free space at all, and it usually offers a button that opens Storage settings.

That matters more than it sounds. macOS writes swap files when memory is tight, apps write caches and autosaves constantly, and updates need room to unpack. With no free space, apps stall or crash, documents fail to save, and Software Update won’t install.

Apple’s own advice for this situation is in Free up storage space on Mac. The steps below follow it, in the order that gets you room fastest with the least risk.

What should I do right now?

1. Save your work and quit what you don’t need (1 minute)

Save every open document. Then quit apps that write a lot in the background: browsers with many tabs, video and photo editors, virtual machines, Docker, and anything downloading. This stops the disk filling further while you work.

2. Empty the Trash (1 minute)

Files in the Trash still use space. Right-click the Trash in the Dock and choose Empty Trash.

If you recently deleted photos, they’re still in Photos’ Recently Deleted album (under Utilities in the sidebar) for 30 days. Unlock it, select what you’re sure about and delete it. That’s permanent.

3. Clear your Downloads folder (5 minutes)

In Finder, choose Go › Downloads. Press Command-2 for List view and click the Size column. Delete:

  • Installers (.dmg, .pkg) for apps you’ve already installed.
  • Archives (.zip) you’ve already opened.
  • Videos and files you’ve already filed somewhere else.

Empty the Trash again when you’re done.

4. Delete large files you recognise (5 to 10 minutes)

  1. Open Apple menu › System Settings.
  2. Click General, then Storage.
  3. Click the info button (i) next to Documents.
  4. Open Large Files, select anything you don’t need, and click Delete.

Old screen recordings, exported videos, disk images and VM files are the usual finds.

5. Restart (2 minutes)

A restart clears swap files and temporary items, and it gives macOS a chance to purge what it was holding as purgeable (local Time Machine snapshots and some caches). It often frees a few gigabytes with no effort. Check Storage settings again after.

6. If you need room for a macOS update: safe mode once

Apple says that starting in safe mode clears certain system caches that are recreated as needed, and that this can free enough space for something like a macOS update. On a Mac with Apple silicon, per Apple’s safe mode guide:

  1. Choose Apple menu › Shut Down and wait until the screen is black.
  2. Press and hold the power button until “Loading startup options” appears.
  3. Select your startup disk.
  4. Hold Shift and click Continue in Safe Mode.
  5. Log in, then restart normally.

On an Intel Mac (macOS 26 Tahoe and earlier), hold Shift right after pressing the power button until the login window appears.

Then run System Settings › General › Software Update again.

What if that’s still not enough?

Now you have some breathing room, work through the bigger, slower wins. They’re all safe if you do them in the app that owns the data.

StepWhereWhy it helps
Uninstall apps and games you don’t useStorage › Applications (i), or the game’s launcherApps and games are often tens of GB
Delete old iPhone and iPad backupsFinder › your device › General › Manage Backups (Apple’s steps)Each backup can be the size of the device
Remove large Messages attachmentsStorage › Messages (i)Years of videos and photos add up
Turn on Store in iCloud and Optimize StorageStorage › RecommendationsmacOS keeps only recent files locally
Move Photos or video libraries to an external driveApple’s guideOften the single biggest win
Remove local Time Machine snapshotsSystem Settings › General › Time Machine › Options › Backup Frequency › Manually, then back (Apple’s snapshot article)Frees purgeable space now instead of later
Clear Xcode, Docker and package cachesXcode › Settings › Components, inside Docker, each package managerOften the biggest win on a developer’s Mac

The full list, ranked by impact and safety, is in how to free up space on a Mac. If you’re a developer, go straight to what’s eating your Mac’s disk, the developer guide.

Why is my disk full when I don’t have many files?

Look at the Storage bar. If System Data is the biggest category, your files aren’t the problem. System Data holds caches, logs, local snapshots, swap, iPhone backups and container or VM disk images, and Storage settings won’t show you what’s in it.

A quick, read-only check in Terminal (give Terminal Full Disk Access first in System Settings › Privacy & Security, or protected folders show “Operation not permitted”):

du -sh ~/Library/Caches ~/Library/Containers ~/Library/Developer \
  "$HOME/Library/Application Support/MobileSync/Backup" 2>/dev/null | sort -h
tmutil listlocalsnapshots /

Our guide to System Data on Mac storage walks through each part and the safe way to shrink it.

Also check whether the disk is really full. Finder counts purgeable space as available, while some apps and df in Terminal don’t, so you can see “almost full” warnings from one place and plenty of room in another. What purgeable space is explains the gap.

What should I never delete to free space?

When the warning is on screen, it’s tempting to delete anything big. Don’t touch:

  • /System, /private, /Library/Apple or anything else macOS installed. Much of it is protected anyway, and the rest it needs.
  • ~/Library folders you can’t name. Especially Containers, Group Containers and Application Support, which hold app data, not just cache.
  • ~/Library/Mobile Documents. It’s your iCloud Drive; deleting from it deletes from iCloud on every device.
  • Photos Library, Music, Final Cut or Logic libraries from Finder. Remove items inside the app, or move the whole library with Apple’s steps.
  • Docker’s disk image or a virtual machine file. They hold your containers, volumes and VMs. Prune inside the app.
  • Xcode Archives unless you’ve kept the dSYMs elsewhere. You need them to read crash reports.
  • Your only backup of anything. Check the external drive works before you delete the original.

If a “cleaner” app offers to remove gigabytes in one click, look at what’s on the list before you agree. Our look at CleanMyMac alternatives covers what those apps do.

How do I stop the warning coming back?

  • Turn on Empty Trash automatically in Storage settings, or Finder › Settings › Advanced › Remove items from the Trash after 30 days.
  • Keep an eye on free space. FavTray’s free System tool shows disk usage for each drive in the menu bar.
  • Find what grew. The warning usually has one cause: a new game, a video project, a Docker image or a phone backup. Knowing which one tells you what to watch.

How does FavTray Space help?

We make FavTray, so weigh our take accordingly.

FavTray Space is a read-only disk map. A treemap shows every folder by size, and about 115 rules name what’s in it: caches, iPhone backups, Mail and Messages attachments, installers in Downloads, games, creative-app caches, Docker, VMs, Xcode and more. Worth a look ranks items by size and by how easily they come back, and never offers your own work. It never deletes, moves or changes a file. “Where to clear it” opens the app that owns each item with the menu path, so the deleting happens in Finder, Photos, Steam, Xcode or Docker, where it’s safe.

To stop the next surprise: a low-disk alert (at 10% free by default, checked hourly) is in the free tier. On Pro, History shows what grew this week and forecasts when the disk fills. Free also shows capacity, used, purgeable and free space, and the top 3 categories with names hidden. Pro names everything, and the alert names the top 3 items. There’s a 7-day full trial with no card, then a one-time Lifetime licence (pricing). macOS 14 Sonoma or later, 100% local.

To check your numbers any time, see how to check disk space on a Mac.

Try FavTray Free

One free Mac menu bar app: notch island, ports, keep-awake, clipboard, eye rest, and Claude and Codex limits.

Download Free

Frequently Asked Questions

What does 'your startup disk is almost full' mean on a Mac?

The startup disk is the internal drive macOS runs from, usually called Macintosh HD. The warning means it has very little free space left. macOS needs free space for swap, caches, app updates and system updates, so when it runs out, apps can stall, saves can fail and updates won't install. Freeing even a few gigabytes helps right away.

What should I delete first when my Mac's startup disk is full?

Empty the Trash, then delete old installers and archives from Downloads, then large files you recognise from System Settings › General › Storage › Documents. These are safe because you can see exactly what they are. Leave system folders, ~/Library and app libraries alone until you have breathing room.

Can a full startup disk damage my Mac?

It won't damage the hardware, but it can cause real problems: apps crash, documents fail to save, the Mac slows down as swap has nowhere to go, and macOS updates refuse to install. Free some space as soon as you see the warning, and save your open work first.

Why is my startup disk full when I don't have many files?

Usually System Data: caches, local Time Machine snapshots, swap, iPhone backups, or a Docker or virtual machine disk image. Storage settings doesn't break it down, so use du in Terminal or a read-only disk map to find the big items. Restarting often frees a few gigabytes on its own.

How do I free space on a Mac if it's too full to install an update?

Empty the Trash and clear Downloads, then restart. If that's not enough, start up in safe mode once: Apple says safe mode clears certain system caches, which can free enough space for an update. Then restart normally and run Software Update again.