What is the “RECLAIMABLE” space displayed in docker system df?

Question

One can use the command docker system df (mirror) (introduced in Docker 1.13.0) to see docker disk usage, e.g.:

username@server:~$ docker system df
TYPE                 


        

Answer 1

Hi @Franck Dernoncourt!
RECLAIMABLE is the space consumed by "unused" images (in the meaning of no containers based on thoses images is running). In other words and as @jordanm said, this is the total size of images you can remove without breaking anything, that is exactly why Docker will remove them if you run docker system prune -a or docker image prune -a. The -a tells Docker to remove all unused images, without it Docker only removes dangling (untagged) images.

You can learn more on how optimize your disk space with Docker here and here and of course Docker documentation for docker image prune and docker system prune.

Answer 2

It's worth mentioning in addition to Kerat's answer, the command you may be looking for to free up space listed as RECLAIMABLE is docker system prune -a --volumes. Volumes will not be pruned by default if you don't include the --volumes flag.