Files
docker-cli/docs/reference/commandline/volume_prune.md
Sebastiaan van Stijn f30bde6adb remove unneeded comment from reference files
these markdown files are not consumed directly in the docs,
but only their content is included through the YAML does,
so there's no need to have these comments in them

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2020-03-19 15:15:23 +01:00

1.9 KiB

title, description, keywords
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>, or label!=<key>=<value>) - only remove volumes with (or without, in case label!=... 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.