How to Fix macOS Startup Disk Full

In this tutorial, you'll learn about How to Fix macOS Startup Disk Full. We cover key concepts, practical examples, and best practices.

The Problem

macOS warns:

Your disk is almost full.
About 1.24 GB remaining on your startup disk.

Or the system becomes sluggish, apps fail to launch, and you cannot download updates.

The startup disk has less than 10% free space, causing macOS to slow down and behave unpredictably.

Quick Fix

Step 1: Check storage usage

Click the Apple menu > About This Mac > Storage.

Or use Terminal:

du -sh /* 2>/dev/null | sort -rh | head -10

This shows the largest directories at the root level.

Step 2: Clear Time Machine local snapshots

tmutil listlocalsnapshots /
tmutil deletelocalsnapshots /

Time Machine stores local snapshots on the startup disk when the backup drive is unavailable. Deleting them can free 10-50 GB.

Step 3: Clean system caches

sudo rm -rf ~/Library/Caches/*
sudo rm -rf /Library/Caches/*

Caches are safe to delete. Applications recreate them as needed.

Step 4: Remove iOS backups and device firmware

rm -rf ~/Library/Application\ Support/MobileSync/Backup/*

Old iPhone and iPad backups can consume 20-100 GB.

Step 5: Clear system logs

sudo rm -rf /private/var/log/*

Log files grow over time, especially with verbose logging enabled.

Step 6: Remove unused language resources

sudo rm -rf /Applications/Xcode.app/Contents/Developer/Platforms/iPhoneOS.platform/Developer/Library/Xcode/Templates

For Xcode users, removing simulator runtimes and device support files frees significant space:

xcrun simctl delete unavailable

Step 7: Use the built-in Storage Management

1. About This Mac > Storage > Manage
2. Review Recommendations (Store in iCloud, Empty Trash Automatically)
3. Check Documents for large files
4. Review Mail for large attachments

Step 8: Clear Xcode derived data

rm -rf ~/Library/Developer/Xcode/DerivedData/*

Xcode derived data can exceed 20 GB for active projects.

Step 9: Find and delete large files

find ~ -type f -size +100M -exec ls -lh {} \; 2>/dev/null

Review the list and delete files you no longer need.

Prevention

• Keep at least 10-15% of disk space free at all times.
• Store photos and videos in iCloud or on external drives.
• Delete old Xcode simulator runtimes after updating.

Common Mistakes with disk full

1. Overlapping type class instances that cause GHC to reject the program with ambiguous dispatch errors
2. Non-exhaustive pattern matches that compile with warnings then crash at runtime
3. Misunderstanding that String is [Char] with poor performance for large text operations

These mistakes appear frequently in real-world MACOS code. DodaTech's contributors have identified these patterns through analysis of open-source projects and production systems.

Practice Exercise

Write a pure function that safely divides two integers using Maybe, then test it with edge cases like division by zero and negative numbers.

This exercise reinforces the concepts covered in this guide. Try implementing it before checking online solutions.

FAQ

DodaTech Tool Reference

DodaZIP's Disk Space Analyzer visualizes storage usage across your Mac, identifying the largest files and folders with an interactive treemap.