docker/cli

mirror of https://github.com/docker/cli.git synced 2025-09-11 06:30:44 +03:00

Files

Ed Morley 6e2e92d774 Update docs/command output for volume pruning

In previous versions of the Docker API, `system prune --volumes` and `volume prune`
would remove all dangling volumes. With API v1.42, this was changed so that only
anonymous volumes would be removed unless the all filter was specified.

Some of the docs were updated in #4218, however, there were a couple of places
left that didn't make the anonymous vs named volumes distinction clear.

This replaces #4079, which was bitrotted by #4218. See also #4028.

Closes #4079.

Signed-off-by: Ed Morley <501702+edmorley@users.noreply.github.com>

2023-08-12 14:22:23 +01:00

2.3 KiB

Raw Blame History

volume prune

Remove unused local volumes

Options

Name	Type	Description
`-a`, `--all`		Remove all unused volumes, not just anonymous ones
`--filter`	`filter`	Provide filter values (e.g. `label=<label>`)
`-f`, `--force`		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>, 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.

2.3 KiB Raw Blame History