Show Docker disk usage
Build a paste-ready command, then review its compatibility and effects before running it.
read-onlyno known side effects Compatibility
Linux + macOSVerified for Linux, macOS using posix, bash, zsh syntax.
Operational knowledgereview due 2027-01-19
Requirementsdockerdocker must be installed and available on PATH.
Version supportdocker Current supported releasesVerified for linux, macos using posix, bash, zsh syntax; consult compatibility notes for platform-specific differences.
Expected signalsTYPE TOTAL ACTIVE SIZE RECLAIMABLERepresentative successful output; values vary with the selected target and system state.
Known errorsdocker: command not founddocker is missing or is not available on PATH.
Verifydocker system dfThe output matches the expected target and exits without an error.Rollback noteNot required: this command is read-only and does not change system state.
Command breakdown
01dockerDocker CLIConnects to the Docker engine.
02systemEngine-wide operationsSelects commands that describe or manage Docker’s overall state.
03dfDisk usageSummarizes space used by images, containers, volumes, and build cache.
Example input
docker system df
Example output
TYPE TOTAL ACTIVE SIZE RECLAIMABLE
Images 12 4 6.84GB 2.11GB (30%)
Containers 6 4 128MB 14MB (10%)
Local Volumes 9 3 18.2GB 4.7GB (25%)
Illustrative output — exact values vary by system and data.
Runbooks
Official sources