Mac Startup Disk Full — Free Up Space and Identify Large Files

Fix Mac 'Your startup disk is almost full' warning by identifying large files, clearing system caches, managing Time Machine snapshots, and optimizing storage. This guide covers everything you need to know about this topic, including common causes, step-by-step solutions, and answers to frequently asked questions.

Here are the key things to understand: macOS needs 10-15% free space on the startup disk for virtual memory, swap files, and updates. System Data (shown in About This Mac > Storage) includes caches, logs, and Time Machine local snapshots. Time Machine local snapshots can consume 50GB+ and are not easily visible in Finder. Xcode, Docker, and virtual machines are common hidden space consumers in developer setups. iCloud 'Optimize Mac Storage' can free up space by keeping only recent files locally. Understanding these fundamentals will help you diagnose and resolve this issue more effectively.

The most common reasons this occurs include: Large files accumulated in Downloads, Desktop, or Documents folders. Application caches growing excessively (Xcode, browsers, Spotify). Time Machine local snapshots consuming space while backup disk is disconnected. Deleted files still in Trash consuming disk space. macOS system updates downloaded but not yet installed. Identifying the root cause is the first step toward finding the right solution.

To resolve this, follow these recommended steps: Check storage: Apple menu > About This Mac > Storage (or System Settings > General > Storage on newer macOS). Use the storage management tool: click Manage in the Storage view for category-by-category cleanup options. Empty Trash: Finder > Empty Trash (or right-click Trash icon > Empty Trash). Delete Time Machine local snapshots: tmutil listlocalsnapshots / then tmutil deletelocalsnapshots <date>. Clean application caches: ~/Library/Caches/ — delete folder contents (not the folders themselves). Enable Optimize Mac Storage for iCloud: System Settings > Apple ID > iCloud > Optimize Mac Storage. Use a tool like DaisyDisk or GrandPerspective to visualize disk usage. If these steps do not resolve the issue, consider consulting additional resources or a qualified professional.

This article is part of our Mac Error Codes collection on Error Codes Wiki. We provide comprehensive, up-to-date information to help you find solutions quickly.