Guides

Docker taking up space on Mac: Docker.raw explained

Docker Desktop keeps everything in one big file. Here's how to see what's in it and shrink it without losing data you need. Updated 20 October 2026.

What Docker.raw is

Docker runs Linux containers inside a small virtual machine. Docker Desktop stores that machine's disk, with all your images, containers, volumes and build cache, in one file:

~/Library/Containers/com.docker.docker/Data/vms/0/data/Docker.raw

If you've moved it with Docker Desktop's Disk image location setting, it lives there instead.

Its real size is usually smaller than it looks

The file has a maximum size, but only the space actually written is used on your disk. Some tools show the maximum, so a file listed as 64 GB may use far less. To see both, run:

cd ~/Library/Containers/com.docker.docker/Data/vms/0/data
ls -klsh Docker.raw

The first number is the space actually used, in kilobytes. The size next to the date is the maximum.

See what's using it

With Docker Desktop running, docker system df shows how much space images, containers, local volumes and build cache use, and how much of each is reclaimable. Add -v for a line per image, container and volume.

Clear it from the inside

Be careful with volumes. Databases and other container data often live in a volume, and a volume isn't rebuilt from anything. Run docker volume ls first and only prune volumes when you know none of them hold data you want.

Space can take a few minutes to come back to macOS after you delete images. Deleting files inside a running container doesn't shrink Docker.raw.

Change the disk limit

Open Docker Desktop's Settings → Resources → Advanced. Disk usage limit sets the most space Docker can use (older versions call it Disk image size), and Disk image location moves the file, for example to an external drive.

Docker's documentation warns that lowering the size deletes the current disk image, with every container and image in it. Push any images you want to keep to a registry, or export important volume data, before you make it smaller.

Don't delete Docker.raw in Finder

Deleting the file removes every image, container and volume at once, and moving it to the Trash while Docker is running can leave Docker in a bad state. Use the commands above, or lower the disk limit once you've saved what you need.

What CheckMac does here

CheckMac shows Docker.raw on the disk map with two sizes: Allocated, the space it actually takes on your disk, and Logical, its full apparent size. That tells you quickly whether Docker is really the problem. CheckMac doesn't look inside the disk image and never suggests it for cleanup, because only Docker knows which images and volumes you still need. For the rest of a developer Mac, see the developer checklist.

CheckMac's Suggested Cleanup sheet: a plain-language summary of what it found, then build output and package caches with their sizes and how each one is rebuilt. CheckMac's Suggested Cleanup sheet: a plain-language summary of what it found, then build output and package caches with their sizes and how each one is rebuilt.

See it on your own Mac. CheckMac maps any folder or drive as a sunburst or treemap, and Suggested Cleanup lists the caches and build output a tool can rebuild, with what each one costs you. Scanning is free, and Suggested Cleanup is free for its first three runs.

Download CheckMac See how it works

More guides