Startup Disk Full on Mac? Fix "Your Startup Disk Is Almost Full"

What "Your disk is almost full" actually means

The startup disk is the drive your Mac boots from and where macOS, your apps, and your user files all live. When free space on that disk drops to a critically low level, macOS shows the "Your disk is almost full" alert — and it is not just a suggestion. macOS needs breathing room on the startup disk for virtual-memory swap files, app installers and updates, temporary files, and the caches that keep everyday apps responsive. When that room runs out, things start failing in ways that do not obviously point back to disk space.

The symptoms of a nearly full startup disk are easy to misdiagnose: apps launch slowly or refuse to open, the spinning beach ball shows up constantly, macOS updates fail to download or install, saving a file throws an error, and in extreme cases the Mac will not finish booting at all. That is because macOS uses free disk space as an extension of RAM — when memory fills up, the system swaps data to disk, and a full disk leaves it nowhere to swap.

How much free space is healthy? Apple does not publish a single official number, but in practice you want to keep roughly 10-15% of the disk free, and never let it fall below about 20 GB on a modern Mac. macOS updates alone can require well over 20 GB of temporary space to install, and a machine running with only a few gigabytes free will feel slow long before it is technically full. One more thing worth knowing before you start: the Storage screen counts some space as "purgeable" — data like Time Machine local snapshots and iCloud-synced files that macOS will remove automatically when space is needed. That is why the free-space number in Finder and the one in System Settings sometimes disagree, and why deleting files does not always move the meter right away.

Which warning are you seeing? Every variant, decoded

Apple has reworded this alert several times, and the wording tells you which problem you actually have. "Your disk is almost full" is the modern macOS phrasing (Ventura and later). "Your startup disk is almost full" is the same warning on earlier releases, and it is still the phrase most people search for. Both mean the same thing: free space on the boot volume has fallen low enough that macOS wants you to act. The fix is everything below — delete files, clear caches, offload media.

"Your Mac OS X startup disk has no more space available for application memory" is a different alert, even though it names the startup disk. So is its modern successor, "Your system has run out of application memory." These are memory-pressure warnings: macOS ran out of RAM, tried to page data out to swap files on the startup disk, and found no room there either. The dialog usually lists the apps consuming the most memory and offers to force-quit them. Quitting the worst offender clears it immediately — but the underlying reason swap failed is still a full disk, so the cleanup steps below are what stop it from coming back.

Two more variants worth naming. Saving a document and getting "The disk is full" or error code -34 is the same condition surfacing at the file-system level rather than as a notification. And if macOS reports the startup disk is full within seconds of you deleting several gigabytes, you are almost certainly looking at purgeable space rather than a stale number — see the note at the end of the next section.

Quick wins: Trash, Downloads, and large files

Start with the moves that take minutes and free the most obvious space. The single most common mistake is deleting files without emptying the Trash — everything you "delete" in Finder still occupies disk space until the Trash is emptied, so gigabytes of freed space can be sitting one click away.

The Downloads folder is the next classic offender. Installers (.dmg and .pkg files), zip archives you already extracted, and email attachments you saved once and forgot are pure dead weight. A disk image is useless the moment the app inside it is installed; sort Downloads by size to measure what your own folder can return.

macOS also has a built-in large-file finder that most people never open. It lives in the Storage settings and lists your biggest files and downloads across the whole disk, sorted by size, with a delete button right there. Ten minutes in that list often recovers more space than an hour of browsing folders by hand.

1. Empty the Trash: click and hold the Trash icon in the Dock, then choose Empty Trash. If you use Mail, also erase Mail's own trash (Mailbox > Erase Deleted Items) — deleted attachments count against your disk too.
2. Open System Settings from the Apple menu, click General in the sidebar, then click Storage (on macOS Monterey, use Apple menu > About This Mac > Storage > Manage instead). Wait for the colored bar to finish calculating so the numbers are accurate.
3. Under the recommendations, click the Info button next to Documents (or Applications), then open the Large Files and Downloads tabs. Sort by size, select anything you no longer need, and click Delete.
4. In Finder, open your Downloads folder, choose View > As List, and click the Size column to sort largest first. Trash old installers, disk images, and archives you have already used.
5. Back in the Storage settings, consider the built-in recommendations: Empty Trash Automatically removes items after 30 days, and Store in iCloud offloads files you rarely open (they re-download on demand).
6. Empty the Trash one final time, then restart your Mac — a restart clears swap files and temporary folders, which can instantly return several extra gigabytes.

If the free-space number barely moves after all this, do not panic — macOS may be holding purgeable space (like local Time Machine snapshots) that it releases on its own schedule. The System Data section below covers the space you can reclaim yourself.

When the disk is so full you cannot delete anything

There is a nastier version of this problem: the disk is at 100%, and every escape route needs space you do not have. Finder refuses to empty the Trash, Storage settings never finishes calculating, apps quit on launch, and in the worst case the Mac stops short of the desktop. The order below goes from least to most invasive — stop as soon as you have a few gigabytes back, then run the normal cleanup.

Start with a restart. It is not folklore: rebooting discards swap files, /tmp, and a pile of per-session caches, and on a wedged disk it routinely returns several gigabytes — often just enough to make Finder cooperate again. If the Trash still will not empty afterwards, delete in smaller batches; a single enormous item can fail where ten smaller ones succeed.

Next, look at Time Machine local snapshots. macOS keeps hourly snapshots of the boot volume even when no backup drive is attached, and normally thins them on its own — but that automatic thinning assumes the system has room to work in, which is exactly what a 100%-full disk denies it. This is the one case where clearing them by hand is the right call, and Apple ships a supported command for it.

If the Mac will not boot at all, hold Shift during startup on Intel (or hold the power button, pick your volume, then hold Shift and click Continue in Safe Mode on Apple Silicon). Safe Mode skips login items and clears some system caches, which is frequently enough to get you to a usable desktop. If even that fails, boot into macOS Recovery — Command-R on Intel, hold the power button on Apple Silicon — run Disk Utility's First Aid on the volume, then use Recovery's Terminal or an external drive to move large files off before booting normally.

1. Restart the Mac, then try emptying the Trash again — start with the largest items and work down in small batches.
2. Open Terminal and run tmutil listlocalsnapshots / to see the local snapshots macOS is holding on the boot volume.
3. Free them in one pass with sudo tmutil thinlocalsnapshots / 20000000000 4 — that asks macOS to reclaim roughly 20 GB at the most aggressive urgency level. Repeat with a larger number if you need more.
4. Still stuck? Boot into Safe Mode (Shift on Intel; power button > volume > Shift > Continue in Safe Mode on Apple Silicon), empty the Trash there, and restart normally.
5. If the Mac will not reach the desktop, boot macOS Recovery, run First Aid in Disk Utility, then copy your largest personal files (Photos library, video projects, Downloads) to an external drive and delete the originals.

Do not try to free space by deleting anything inside /System, /private, or /Library that you did not put there. Swap files and system caches are recreated instantly, and removing the wrong file turns a full disk into an unbootable Mac.

System Data — called "Other" on older macOS — is usually the biggest slice

If you have been searching for what the "Other" category on a full startup disk contains, this is it under a new name. Up to macOS Monterey the storage bar had a large gray wedge labelled Other; Ventura renamed it System Data without changing what it counts. Same slice, same causes, same cleanup — so advice written about "Other" storage still applies, you just look for System Data in System Settings now.

Once the quick wins are done, hover over the storage bar in System Settings > General > Storage and look at the light gray segment near the end: System Data. On most Macs with a full startup disk, this is the largest single category — 30, 50, sometimes 100+ GB — and it is also the most confusing, because it is not a folder you can open. It is a running total of app caches, logs, temporary files, virtual-memory swap, Time Machine local snapshots, old iPhone backups, and developer files scattered across the disk.

For a full-disk rescue, two targets inside System Data pay off fastest. The first is ~/Library/Caches: because apps rebuild their caches on demand, its largest folders can be cleared without losing anything permanent. The second is stale local device backups — if you have ever backed up an iPhone or iPad to this Mac, those snapshots may still be here years later. Check via Finder's Manage Backups button (select any connected device in the sidebar) instead of hunting for the folders manually, so the backup index stays intact.

What you should not touch: the swap files and local snapshots that macOS manages itself. Swap lives in a protected system area and is recreated as needed; local snapshots are automatically thinned by macOS when disk space runs low. Deleting things inside /System or /private is never worth the risk. System Data cleanup is a deep enough topic that we wrote a dedicated guide to it — "How to Clear System Data Storage on Mac" walks through every folder, path, and safety rule in detail. For a full-disk rescue, measure the largest cache folders and stale device backups before deciding whether they are worth removing.

Developers: Xcode and simulators are probably the culprit

If Xcode has ever been installed on your Mac, stop and check the developer folders before anything else — they are very likely the reason your startup disk is full. The single biggest offender is DerivedData, Xcode's folder of intermediate build products; after a few active projects it commonly holds tens of gigabytes, all of which Xcode regenerates automatically the next time you build. Deleting it costs you nothing but one slower first build per project.

Simulators come next. Each downloaded simulator runtime is a multi-gigabyte install, and every simulated device keeps its own data folder, so a Mac that has lived through several Xcode upgrades usually carries runtimes for OS versions nobody targets anymore. Two cleanups cover it: run xcrun simctl delete unavailable in Terminal to drop simulator devices whose runtimes are gone, then open Xcode's Settings > Platforms (called Components in older Xcode versions) and delete the old runtimes themselves, keeping only the latest per platform.

Add in the download caches kept by package managers — npm, CocoaPods, Swift Package Manager, Homebrew, pip, cargo — and developer storage can become one of the highest-impact categories on the disk. The result varies by machine. Our dedicated guide "Delete Xcode DerivedData & Developer Caches Safely" walks every path and command in detail, including archives and iOS DeviceSupport symbols.

Photos and videos: the space you actually care about

Media is different from caches: you cannot regenerate a photo, so this is where cleanup needs judgment instead of bulk deletion. Start by checking how big the problem is — in the Storage settings, the Photos category shows what your library occupies, and on many Macs it rivals or exceeds System Data.

The safest first move is deduplication. On macOS Ventura and later, the Photos app has a built-in Duplicates album (in the sidebar under Utilities) that finds exact and near-exact copies and merges them, keeping the highest-quality version. Beyond duplicates, the usual dead weight is screenshots, screen recordings, burst shots, and videos — a single 4K video can equal a thousand photos in size. In the Photos sidebar, the Media Types section breaks your library into Videos, Screenshots, and Screen Recordings — open each and review the biggest and oldest items first.

If you pay for iCloud, turning on Optimize Mac Storage in Photos settings keeps full-resolution originals in iCloud and only device-sized versions locally — often the single biggest space win on a media-heavy Mac, with nothing actually deleted. Just remember it is a sync service, not a backup: deleting a photo removes it from every synced device, and once its 30 days in Recently Deleted are up it is gone for good.

MacBook Air and 256 GB Macs: the small-SSD playbook

If your startup disk is full on a base-model MacBook Air or any 256 GB Mac, the arithmetic is against you before you save a single file. A current macOS install plus its bundled apps occupies somewhere in the 20-35 GB range, the 10-15% free-space buffer claims another 25-40 GB, and a major macOS upgrade wants 20+ GB of temporary room on top. On a 256 GB machine that leaves under 200 GB of genuinely usable space — which is why these Macs hit the warning with what feels like almost nothing on them. On a 128 GB Air the situation is tighter still, and the strategy has to shift from cleaning to relocating.

The highest-leverage move is getting your media off the internal disk. Quit Photos, drag the Photos Library from your Pictures folder to an external SSD, then hold Option while reopening Photos and choose the library in its new location (and set it as the System Photo Library in Photos settings if you use iCloud). The same applies to video projects, virtual machines, and sample libraries — anything large that you use occasionally rather than constantly. If you pay for iCloud, turning on Desktop & Documents Folders sync plus Optimize Mac Storage lets macOS keep only what you are actively using on the SSD.

Two things to accept on a small disk. Xcode plus several simulator runtimes, active-project DerivedData, and a media library can consume a large share of a 256 GB disk, so measure developer storage after each project and move suitable media to an external volume. And the internal SSD is not upgradeable on Apple Silicon Macs, so an external drive plus a monthly sweep is a long-term capacity plan.

Keep it from filling up again

A startup disk that filled up once will fill up again unless a few habits change. The good news is that prevention takes minutes a month, not hours.

First, make the built-in automation work for you: turn on Empty Trash Automatically in the Storage settings so deleted files stop lingering for months, and leave Optimize Storage on if you use Apple TV purchases or large Mail attachments. Second, adopt a monthly ten-minute sweep: empty Downloads, glance at the Large Files list in Storage settings, and — if you are a developer — clear DerivedData and run xcrun simctl delete unavailable after finishing a project.

Third, watch the trend, not just the number. If free space shrinks by gigabytes every week and you are not creating files, something is caching aggressively — a browser, a messaging app storing years of media, or an AI tool downloading models. Finding that one app early is easier than rescuing a full disk later. This is where a cleanup tool earns its keep: instead of you re-checking a dozen folders every month, AskClean runs the whole sweep in one scan across 12 categories — from system and browser caches to developer junk, AI model caches, app leftovers, and large downloads — with an AI explanation attached to each finding so you know what an item is and what deleting it would cost before you decide. Nothing runs without your confirmation, deletions go to the Trash where they stay restorable, and because scanning is free and unlimited you can treat it as a monthly disk-health check — the one-time $14.99 purchase only matters if you want it to do the cleaning too.

FAQ