What to Do When Mac Storage Is Completely Full (Emergency Guide)
Emergency recovery guide when your Mac disk is at 100%, macOS throws startup disk warnings, and apps freeze.
Why a 100% Full Mac Disk Is an Emergency
When an APFS internal drive has zero bytes free, macOS cannot allocate virtual memory swap space or update system databases. This results in apps crashing, Finder freezing, inability to empty the Trash, and in severe cases, failure to boot past the Apple logo.
Follow these emergency procedures to safely recover at least 5GB–10GB immediately.
Immediate Emergency Recovery Steps
1. Empty Trash via Terminal (Bypassing Finder)
When disk is 100% full, Finder often refuses to empty Trash because it lacks scratch disk space. Use Terminal:
2. Clear Downloads & Large Installer DMGs
Old .dmg installers and archives sitting in Downloads can be wiped instantly:
3. Reboot into Safe Mode
On Apple Silicon (M1/M2/M3/M4), shut down your Mac, then hold the Power button until "Loading startup options" appears. Select your drive, hold Shift, and click Continue in Safe Mode. Safe Mode forces macOS to automatically purge kernel temporary swap files and system caches.
Maintain a Safe Storage Buffer with XrayMac
XrayMac features live hardware telemetry in its sidebar that continuously warns you before your APFS drive drops below the critical 15GB threshold. Run 1-Click Smart Clean to keep at least 20% of your SSD free for optimal APFS wear-leveling and swap performance.
Frequently Asked Questions
How much free space does macOS need to run smoothly?
macOS requires at least 15% to 20% free space (around 20GB–40GB) for virtual memory paging, APFS copy-on-write snapshots, and wear leveling.
Why does my Mac say storage is full when I just deleted files?
Deleted files in macOS APFS are often retained inside Time Machine local snapshots until purged.
XrayMac Engineering Team
Pure Swift 6 & APFS storage diagnostics for macOS Sonoma & Sequoia.