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 TOTAL ACTIVE SIZE RECLAIMABLE
Images 44 28 114.7GB 84.84GB (73%)
Containers 86 7 62.43GB 41.67GB (66%)
Local Volumes 2 1 0B 0B
Build Cache 0B 0B
How is the "RECLAIMABLE" displayed in docker system df
computed? I.e., what does it represent?
The Docker documentation on docker system df
(mirror) doesn't explain it. The Docker glossary (mirror) doesn't contain the term "RECLAIMABLE".
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.