mirror of https://github.com/docker/docs.git
80 lines
3.4 KiB
YAML
80 lines
3.4 KiB
YAML
command: docker system df
|
|
short: Show docker disk usage
|
|
long: |-
|
|
The `docker system df` command displays information regarding the
|
|
amount of disk space used by the docker daemon.
|
|
usage: docker system df [OPTIONS]
|
|
pname: docker system
|
|
plink: docker_system.yaml
|
|
options:
|
|
- option: format
|
|
value_type: string
|
|
description: Pretty-print images using a Go template
|
|
deprecated: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
- option: verbose
|
|
shorthand: v
|
|
value_type: bool
|
|
default_value: "false"
|
|
description: Show detailed information on space usage
|
|
deprecated: false
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
examples: |-
|
|
By default the command will just show a summary of the data used:
|
|
|
|
```bash
|
|
$ docker system df
|
|
|
|
TYPE TOTAL ACTIVE SIZE RECLAIMABLE
|
|
Images 5 2 16.43 MB 11.63 MB (70%)
|
|
Containers 2 0 212 B 212 B (100%)
|
|
Local Volumes 2 1 36 B 0 B (0%)
|
|
```
|
|
|
|
A more detailed view can be requested using the `-v, --verbose` flag:
|
|
|
|
```bash
|
|
$ docker system df -v
|
|
|
|
Images space usage:
|
|
|
|
REPOSITORY TAG IMAGE ID CREATED SIZE SHARED SIZE UNIQUE SIZE CONTAINERS
|
|
my-curl latest b2789dd875bf 6 minutes ago 11 MB 11 MB 5 B 0
|
|
my-jq latest ae67841be6d0 6 minutes ago 9.623 MB 8.991 MB 632.1 kB 0
|
|
<none> <none> a0971c4015c1 6 minutes ago 11 MB 11 MB 0 B 0
|
|
alpine latest 4e38e38c8ce0 9 weeks ago 4.799 MB 0 B 4.799 MB 1
|
|
alpine 3.3 47cf20d8c26c 9 weeks ago 4.797 MB 4.797 MB 0 B 1
|
|
|
|
Containers space usage:
|
|
|
|
CONTAINER ID IMAGE COMMAND LOCAL VOLUMES SIZE CREATED STATUS NAMES
|
|
4a7f7eebae0f alpine:latest "sh" 1 0 B 16 minutes ago Exited (0) 5 minutes ago hopeful_yalow
|
|
f98f9c2aa1ea alpine:3.3 "sh" 1 212 B 16 minutes ago Exited (0) 48 seconds ago anon-vol
|
|
|
|
Local Volumes space usage:
|
|
|
|
NAME LINKS SIZE
|
|
07c7bdf3e34ab76d921894c2b834f073721fccfbbcba792aa7648e3a7a664c2e 2 36 B
|
|
my-named-vol 0 0 B
|
|
```
|
|
|
|
* `SHARED SIZE` is the amount of space that an image shares with another one (i.e. their common data)
|
|
* `UNIQUE SIZE` is the amount of space that is only used by a given image
|
|
* `SIZE` is the virtual size of the image, it is the sum of `SHARED SIZE` and `UNIQUE SIZE`
|
|
|
|
> **Note**: Network information is not shown because it doesn't consume the disk
|
|
> space.
|
|
deprecated: false
|
|
min_api_version: "1.25"
|
|
experimental: false
|
|
experimentalcli: false
|
|
kubernetes: false
|
|
swarm: false
|
|
|