mirror of https://github.com/docker/cli.git
2.2 KiB
2.2 KiB
title | description | keywords |
---|---|---|
volume prune | Remove unused local volumes | volume, prune, delete |
volume prune
Usage: docker volume prune [OPTIONS]
Remove all unused local volumes
Options:
--filter filter Provide filter values (e.g. 'label=<label>')
-f, --force Do not prompt for confirmation
--help Print usage
Description
Remove all unused local volumes. Unused local volumes are those which are not referenced by any containers
Examples
$ docker volume prune
WARNING! This will remove all 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
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.