macOS Disk Full: Step-by-Step Guide to Freeing Up Space

Why Does macOS Report 'Disk Full'?

The 'Disk Full' error (or 'Your disk is almost full') is not just a warning—it's a critical system state. When free space on the startup volume (usually Macintosh HD) drops below ~2–5 GB, macOS starts blocking writes of new data, leading to app crashes, an inability to save files, and even system freezes.

The startupdisk (startup disk) is the volume where macOS is installed. It's the filling of this specific disk that triggers the error. Unlike Windows, where you can redirect user profiles to another drive, in macOS many system processes and caches are hardwired to the startup volume.

Main Causes of Low Disk Space

1. App local caches — browsers (Chrome, Safari), messengers (Telegram, Slack), and editors (Adobe, DaVinci Resolve) can accumulate gigabytes of temporary files.
2. Unoptimized Photos library — if the 'Optimize Mac Storage' option is disabled, only previews remain in iCloud while high-resolution originals are stored locally.
3. Duplicates and 'junk' in Downloads — years of accumulated .dmg, .zip, archives, and unused installers.
4. System data and logs — especially after major macOS updates or during active development (Xcode logs, Docker).
5. Old iOS backups — each device can occupy 10–30 GB in the ~/Library/Application Support/MobileSync/Backup/ folder.

Step-by-Step Guide to Freeing Up Space

Follow the steps in the order listed below. Start with diagnostics, then move on to cleanup.

1. Check Detailed Storage Usage Statistics

First, you need to understand what exactly is taking up space.

1. Open  → About This Mac → Storage. macOS groups data into categories: Applications, Documents, Cache, System Data, etc.
2. Click 'Manage' for details. macOS will suggest options: 'Store in iCloud', 'Optimize Storage', 'Empty Trash Automatically', and 'Reduce Clutter' (for video). Enable useful options.
3. For precise analysis, install DaisyDisk (free trial) or GrandPerspective. These utilities show an interactive map of your disk, where each rectangle is a file or folder, and its size represents the space occupied. This is the most visual way to find 'hidden giants'.

# Alternative: quick terminal analysis of the top 20 largest files/folders in the home directory
sudo du -sh ~/* 2>/dev/null | sort -hr | head -20

2. Clear App and System Caches

Cache consists of temporary files apps store to speed up operations. Deleting them is safe but may temporarily slow down some program launches.

1. Open Finder.
2. In the menu, click 'Go' → 'Go to Folder...' (or Cmd+Shift+G).
3. Enter the path ~/Library/Caches and click 'Go'.
4. Inside, you'll see folders named after applications. Open the desired folder and delete all its contents (not the folder itself!). You can select all files inside and move them to Trash.
5. Repeat for the system cache: in the same dialog, enter /Library/Caches (requires admin password).

⚠️ Important: Do not delete the Caches folders themselves, only their contents. Some apps may create folders with permissions that prevent recreation.

# Safe cache cleanup via Terminal (deletes only files older than 3 days)
find ~/Library/Caches -type f -mtime +3 -delete
find /Library/Caches -type f -mtime +3 -delete 2>/dev/null

3. Remove Large and Unnecessary Files

Use macOS's built-in tools to search for large files.

1. Open Finder and go to the 'Downloads' folder (~/Downloads). Sort by size (in the 'Size' column) to immediately spot .dmg disk images, videos, and archives. Delete anything unnecessary.
2. Use Smart Search:
   • In Finder, press Cmd+F.
   • Set the filter: 'Kind' → 'Documents'.
   • In the bottom right, click '+' and add the criterion 'Size' → 'is greater than' → `1 GB'.
   • Review the results and delete unneeded items.
3. Terminal search (more flexible):

   # Find all files larger than 1 GB in the home folder (may take time)
   find ~ -type f -size +1G -exec ls -lh {} \; | awk '{ print $5, $9 }' | sort -hr
   

4. Optimize iCloud and Photos Storage

If you use iCloud, local copies can take up significant space.

1. Open System Settings → your Apple ID → iCloud → Manage Storage.
2. Enable the 'Optimize Mac Storage' option for Photos. After this, high-resolution originals will be stored in the cloud, while optimized previews remain on your Mac.
3. Check the 'Backups' section and delete old device backups you no longer use.
4. In System Settings → General → Storage, click 'Manage' and enable 'Optimize Storage' — macOS will automatically delete watched movies and TV shows from the TV.app.

5. Clean Up Old Installers and Backups

1. .dmg installers: they remain in Downloads after app installation. Delete them manually.
2. Time Machine backups: if you have Time Machine enabled on an external disk, macOS may create local snapshots for faster recovery. They can be deleted:

   # List local snapshots
   sudo tmutil listlocalsnapshots /
   # Delete a specific snapshot (replace <date>)
   sudo tmutil deletelocalsnapshots 2026-02-10-123456
   

   macOS usually deletes them itself, but when disk space is low, you can clear them manually.

6. Consider External Solutions and iOS Backup Cleanup

1. iOS backups in iTunes/Finder:
   • Open Finder → in the sidebar under 'Locations', select your device (or open iTunes).
   • In the 'Backups' section, you'll see a list. Select old ones and click 'Delete Backup'.
   • File path: ~/Library/Application Support/MobileSync/Backup/.
2. External drive: for archives, photos, and videos needed rarely, use a USB-C/Thunderbolt SSD. Move folders like Movies, Photos Library (close Photos first), and Documents there.

Additional Effective Methods

If after completing the main steps space still runs out quickly, check the following.

Check 'System Data' in Detail

The 'System Data' category in the Storage section often contains:

• Logs and cache of virtual machines (Parallels, VMware, UTM). Delete unused VMs or reduce their size.
• Docker cache (if installed). Clean unused images and containers:

  docker system prune -a
  

• Xcode cache and builds. The ~/Library/Developer/Xcode/DerivedData folder can reach tens of gigabytes. Delete its contents.
• Swapfiles. They are created automatically during RAM shortage and deleted after reboot. Simply restart your Mac.

Manage Storage via Terminal (for Advanced Users)

The ncdu utility (not included in macOS) provides a detailed interactive report.

# Install via Homebrew (if installed)
brew install ncdu
# Analyze home folder
ncdu ~

Clean Up Mail (Mail.app)

Email attachments, especially in active threads, can be copied to the local database. In Mail.app: Mail → Delete Attachments (or in the account settings, uncheck 'Download Attachments').

FAQ (Frequently Asked Questions)

Q: Can I just delete the ~/Library folder?
A: No. This is a system folder containing settings for all your applications. Deleting it will cause data loss, reset preferences, and possibly break programs. Delete only specific subfolders (Caches, Logs, Application Support for unused apps).

Q: Why does space run out quickly again after cleanup?
A: Likely, an app with unmanaged cache is actively running (e.g., a browser with hundreds of tabs, a video editor, a game). Close such apps or find cache-limiting options in their settings.

Q: Which third-party utilities are safe?
A: DaisyDisk (excellent visualization), CleanMyMac X (comprehensive cleanup with a safe whitelist), OnyX (free, for advanced users). Avoid 'magic' utilities from unverified sources—they may delete important system files.

Q: What if I have less than 1 GB free and the system won't let me delete files?
A: Restart your Mac. This clears temporary files and swapfiles. If the problem persists, boot into Recovery Mode (Cmd+R at startup) and use Terminal from there to delete large files from an external or different partition.

Q: Will iCloud storage optimization delete my photos from the Mac?
A: No. High-resolution photos remain in iCloud. Optimized, smaller previews will be stored on your Mac. You can download the original by double-clicking if needed. Ensure you have a backup (Time Machine) before making major changes.

Final Recommendations

Regular storage maintenance is the best prevention. Monthly:

1. Clean the 'Downloads' folder.
2. Check Cache (~/Library/Caches).
3. Use Storage Management in System Settings.
4. Delete old .dmg installers and unnecessary videos.

If low disk space is a constant issue, consider an upgrade — replace the built-in SSD with a larger capacity (for unibody MacBooks, this must be done at an authorized service) or use a fast external SSD via USB-C/Thunderbolt for active projects.