DockerCLI/docs/reference/commandline/volume_prune.md

1.9 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>, 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.