SiftMac
Guide · Updated 22 November 2026

How to clear System Data with Terminal, safely

By Mohit Nippanikar, who makes SiftMac

The short answer
On this page
  1. Before you start
  2. Measure: where the space is
  3. Time Machine local snapshots
  4. App caches, logs and crash reports
  5. Xcode, simulators and Docker
  6. What never to delete from Terminal
  7. Questions

1. Before you start

  1. Give Terminal Full Disk Access in System Settings › Privacy & Security › Full Disk Access. Without it, du skips protected folders and you underestimate what’s there. Turn it off again when you’re done.
  2. Note the free space, so you can see what each step won:
df -h /System/Volumes/Data

Paste one command at a time and read what it printed before the next. Every command here works on macOS 14 Sonoma and later, Tahoe and macOS 27 included. Nothing on this page needs you to turn off System Integrity Protection; if a guide tells you to, close it.

2. Measure: where the space is

Your files, apps and System Data live on the Data volume, mounted at /System/Volumes/Data. Measure that, one level deep, biggest last:

sudo du -xh -d1 /System/Volumes/Data 2>/dev/null | sort -h | tail -20

-x keeps du on that one volume, so it doesn’t wander into external drives or count the sealed system volume. It takes a few minutes. Then follow the biggest entry down. The two that usually matter for System Data:

du -xh -d1 ~/Library 2>/dev/null | sort -h | tail -15
sudo du -xh -d1 /System/Volumes/Data/private/var 2>/dev/null | sort -h | tail -10

The first finds what your apps keep in your Library. The second shows macOS’s own working folders, which you’ll mostly leave alone; it’s useful for spotting a runaway log or a huge folders entry. Totals won’t match Storage settings exactly, because APFS clones share space that du counts twice.

3. Time Machine local snapshots

List them:

tmutil listlocalsnapshots /

Each line looks like com.apple.TimeMachine.2026-11-22-101010.local. You have three ways to free them, from gentlest to most thorough:

sudo tmutil thinlocalsnapshots / 20000000000 4
sudo tmutil deletelocalsnapshots 2026-11-22-101010
sudo tmutil deletelocalsnapshots /

The first asks macOS to reclaim about 20 GB (the figure is in bytes) at the highest urgency, 4, by thinning snapshots. The second deletes the snapshot with that date and time; use one from your own list. The third deletes every local snapshot on the startup disk. None of them touches the backups on your Time Machine drive. With Time Machine on, a new snapshot appears within the hour, so do this when you need the room now, not as routine.

4. App caches, logs and crash reports

Find the big caches first:

du -sh ~/Library/Caches/* 2>/dev/null | sort -h | tail -10

Quit the app that owns one, then empty its folder rather than deleting the folder itself. For example, with Chrome quit:

rm -rf ~/Library/Caches/Google/Chrome/*

Type the full path yourself, check it with ls first, and never build it from a variable: if the variable is empty, the command becomes rm -rf /*. Tools with their own cache command should use it:

brew cleanup --prune=all
npm cache clean --force

Old crash reports are safe to remove; apps write new ones when they crash:

rm -rf ~/Library/Logs/DiagnosticReports/*

Leave /Library/Caches and anything starting with com.apple alone unless you know what it is. macOS clears its own caches and logs when it needs space.

5. Xcode, simulators and Docker

Simulators for runtimes you no longer have installed:

xcrun simctl delete unavailable

That removes only simulator devices whose runtime is gone. xcrun simctl list devices shows the rest; delete those from Xcode’s Devices and Simulators window. Whole simulator runtimes are managed in Xcode’s Settings › Components. With Xcode quit, build data can go too, since Xcode rebuilds it:

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

Docker Desktop’s disk image is never deleted by hand. Ask Docker what it can give back, then let it do the work:

docker system df
docker system prune
docker builder prune

docker system prune lists what it will remove and asks first. It keeps volumes, where databases live, unless you add --volumes.

6. What never to delete from Terminal

PathWhat it isWhy not
/SystemmacOS itself, on a sealed read-only volumeSigned and protected; it can’t be cleaned this way
/System/Volumes/VM, /private/var/vmSwap files and the sleep imageIn use while the Mac runs; a restart clears swap
/private/var/dbSystem databases, the unified log, Spotlight and update datamacOS manages it; deleting parts can break updates or logins
/private/var/foldersPer-user temporary files and cachesRunning apps have files open there; a restart clears what’s safe
~/Library/Mobile Documents, ~/Library/CloudStorageiCloud Drive and other cloud foldersDeleting here can delete from the cloud too
~/Library/Containers, ~/Library/Group ContainersApps’ own data, not just cachesChats, libraries and settings live here

And skip sudo purge: it empties the memory cache, not the disk, so System Data doesn’t move.

Questions

Is sudo rm -rf safe for clearing System Data?

Not on system paths, and it’s never needed there. Use tmutil, xcrun simctl, docker and each tool’s own clean command. Use plain rm -rf only on a folder’s contents in your own Library, with the app quit.

Which Terminal command frees the most System Data?

It depends on the Mac, which is why you measure first. Local snapshots, iPhone backups, Docker and old simulators are the usual big ones; caches rarely are.

Why does Terminal say “Operation not permitted”?

Either Terminal doesn’t have Full Disk Access, or the path is protected by System Integrity Protection. The first you can change in Privacy & Security; the second is macOS telling you to leave that path alone.

Does the purge command free storage on a Mac?

No. purge flushes the disk cache held in memory. It doesn’t delete anything on the disk.

How SiftMac handles it. SiftMac does the measuring for you and takes the same safe line: its System Data view removes old macOS installers and device update files when you pick them, moves iPhone and iPad backups to the Undo Shelf for 7 days, and leaves snapshots to macOS and Docker’s disk image to Docker. With Include Docker on, Docker’s unused images and build cache appear under Developer files, freed with Docker’s own commands.

Download SiftMac · scanning is free, and so is your first 2 GB of cleaning · See how it works