mirror of https://github.com/docker/cli.git
2.3 KiB
2.3 KiB
volume prune
Remove unused local volumes
Options
| Name | Type | Default | Description |
|---|---|---|---|
-a, --all |
bool |
Remove all unused volumes, not just anonymous ones | |
--filter |
filter |
Provide filter values (e.g. label=<label>) |
|
-f, --force |
bool |
Do not prompt for confirmation |
Description
Remove all unused local volumes. Unused local volumes are those which are not referenced by any containers. By default, it only removes anonymous volumes.
Examples
$ docker volume prune
WARNING! This will remove anonymous local volumes not used by at least one container.
Are you sure you want to continue? [y/N] y
Deleted Volumes:
07c7bdf3e34ab76d921894c2b834f073721fccfbbcba792aa7648e3a7a664c2e
my-named-vol
Total reclaimed space: 36 B
Filtering (--all, -a)
Use the --all flag to prune both unused anonymous and named volumes.
Filtering (--filter)
The filtering flag (--filter) format is of "key=value". If there is more
than one filter, then pass multiple flags (e.g., --filter "foo=bar" --filter "bif=baz")
The currently supported filters are:
- label (
label=<key>,label=<key>=<value>,label!=<key>, orlabel!=<key>=<value>) - only remove volumes with (or without, in caselabel!=...is used) the specified labels.
The label filter accepts two formats. One is the label=... (label=<key> or label=<key>=<value>),
which removes volumes with the specified labels. The other
format is the label!=... (label!=<key> or label!=<key>=<value>), which removes
volumes without the specified labels.