docker volume prune


Remove all unused local volumes

Usage

$ docker volume prune [OPTIONS]

Refer to the options section for an overview of available OPTIONS for this command.

Description

Remove all unused local volumes. Unused local volumes are those which are not referenced by any containers

For example uses of this command, refer to the examples section below.

Options

Name, shorthand Default Description
--filter Provide filter values (e.g. label=<label>)
--force , -f Do not prompt for confirmation

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

Parent command

Command Description
docker volume Manage volumes
Command Description
docker volume create Create a volume
docker volume inspect Display detailed information on one or more volumes
docker volume ls List volumes
docker volume prune Remove all unused local volumes
docker volume rm Remove one or more volumes
docker volume update Update a volume (cluster volumes only)