macOS 'Disk Full' Error: Causes and Quick Fix

What the "Disk Full" Error Means

The "Disk Full" error (macOS Startup Disk Full) is a system notification that appears when less than 5-10% of free space remains on the primary (startup) disk. The system may display it as a pop-up window, an icon in Finder, or in the "Storage" section.

After this error appears, macOS becomes extremely unstable: applications may crash, the system slows down, file writing becomes impossible, and some programs (like virtual machines or video editors) may refuse to launch entirely. This is a critical state requiring immediate intervention.

Causes

The error occurs due to a physical lack of free disk space. Specific causes typically include:

1. Accumulation of application and system caches. Browsers (Safari, Chrome), messengers, and other programs actively write temporary files that are rarely cleared automatically.
2. Old downloads and installation images. The Downloads folder (~/Downloads) often becomes a "dumping ground" for ISO, DMG, and ZIP archives that are forgotten after use.
3. iOS backups in iTunes/Finder. iPhone/iPad backups can weigh 10-100 GB each and accumulate with each connection.
4. System logs and crash reports. Files in ~/Library/Logs and /Library/Logs constantly grow, especially if there are unstable applications.
5. "Leftovers" from removed programs. When applications are deleted via Trash, their settings and support files often remain in ~/Library/Application Support/ and other hidden folders.
6. Virtual memory and swap files. macOS uses free disk space as an extension to RAM. If the disk is full, the system cannot allocate memory, leading to crashes.

Solutions

Method 1: Quick Cleanup via "Storage Management"

macOS provides a built-in tool that analyzes and suggests removing unnecessary files.

1. Open System Settings → General → Storage (or click the Apple logo → "About This Mac" → "Storage" tab → "Manage").
2. Wait for the analysis to complete. The system will group files by category: "Applications", "Documents", "System", "Cache".
3. Click on a category, for example "Documents"—here macOS will show large files and old downloads. Select unnecessary ones and click "Delete".
4. Go back and select "iOS Backups"—delete copies of devices you no longer use.
5. In the "Cache" category, you can click "Clear" to remove temporary application files.

💡 Tip: The "Store in iCloud" option (in the same menu) can move files to iCloud, but this requires a subscription. For local cleanup, manual work is better.

Method 2: Manual Cache and Temporary File Cleanup

This method allows you to remove hidden files not always visible in "Storage Management".

1. In Finder, open the "Go" menu → "Go to Folder" (or press Cmd+Shift+G).
2. Enter the path ~/Library/Caches and press Go. Inside will be folders for each application. Open the folders and delete their contents (not the folders themselves). For example, for Safari, delete the com.apple.Safari folder contents.
3. Similarly, navigate to ~/Library/Logs and delete old log files (you can delete everything except folders that are actively in use).
4. For system caches (requires admin password), navigate to /Library/Caches and /Library/Logs and clear their contents.

⚠️ Important: Do not delete the com.apple folders in ~/Library/Caches entirely—this could disrupt system services. Only delete files inside them.

Method 3: Cleaning the "Downloads" Folder and Localizations

Often, gigabytes are "hidden" in downloads and language packs.

1. Open the Downloads folder (~/Downloads). Sort files by size (in Finder: View → Show View Options → Size). Delete large archive files (.dmg, .iso, .zip), installation packages that are no longer needed.
2. Remove outdated application localizations. Install the Monolingual utility (free) or do it manually:
   • Navigate to /Applications.
   • For each heavy application (e.g., Adobe, Microsoft Office), right-click → "Show Package Contents".
   • Open the Contents/Resources folder and delete subfolders named *.lproj, except for en.lproj and your native language (e.g., ru.lproj). This can save hundreds of megabytes.

Method 4: Using Third-Party Utilities for Deep Cleaning

If built-in tools aren't enough, specialized programs can find "hidden" files.

1. Download DaisyDisk (paid, but has a trial) or CleanMyMac X (paid with a free trial).
2. Launch the utility and let it scan your disk. It will display an interactive disk map where large blocks represent big files and folders.
3. Manually select for deletion:
   • Browser caches (Chrome, Firefox).
   • Old application versions (e.g., Xcode-old).
   • Temporary virtual machine files (Parallels, VMware).
   • "Orphaned" files (files with no references).
4. Do not delete system files that the utility marks as "unknown" or "system"—this could break macOS.

Method 5: Hardware Solution — Disk Replacement or Expansion

If after all cleanups free space is still low (<15 GB), the physical disk size may be insufficient for your tasks.

1. For MacBook with a replaceable disk (older models up to 2017): purchase a larger SSD (e.g., 1 TB instead of 256 GB) and clone your system using Carbon Copy Cloner or SuperDuper!.
2. For Mac with a non-removable disk: use an external SSD via USB-C/Thunderbolt and move large media files (videos, photos) to it. In System Settings → Storage → Manage, select the "Store in iCloud" option for documents and photos to keep only a minimum locally.
3. Last resort: Completely reinstall macOS. Create a bootable USB drive, format the disk, and install the system from scratch. Before doing this, always make a full backup using Time Machine.

Prevention

To avoid the error recurring:

1. Check storage monthly via "About This Mac" → "Storage". Maintain a free space limit of 15-20%.
2. Clear browser caches weekly (Safari: Preferences → Advanced → Show Develop menu → Empty Caches).
3. Do not store large files on the system disk. Move movies, projects, and databases to an external drive or cloud (iCloud, Dropbox).
4. Disable automatic iOS backups in Finder: when connecting your iPhone, uncheck "Back up all of the data on your iPhone".
5. Use the purge command (requires password) to force-clear caches and memory:

   sudo purge
   

   This command frees memory and temporary files but does not delete user data.

Frequently Asked Questions

Can I delete the ~/Library/Containers folder?
No. This folder contains data for sandboxed App Store applications. Deleting it will break many programs.

Why does space run out again quickly after cleanup?
You likely work with large files (video editing, virtual machines) or an application has a memory "leak" (e.g., unlimited logging). Find the culprit via "Storage Management" and limit its activity.

Is it safe to use sudo rm -rf to delete files?
Dangerous! The rm -rf command permanently deletes files without recovery. Use it only if you are absolutely certain of what you are deleting. It's safer to move files to Trash manually.