f30bde6adb
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>
65 lines
1.9 KiB
Markdown
65 lines
1.9 KiB
Markdown
---
|
|
title: "volume prune"
|
|
description: "Remove unused local volumes"
|
|
keywords: "volume, prune, delete"
|
|
---
|
|
|
|
# volume prune
|
|
|
|
```markdown
|
|
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
|
|
|
|
```bash
|
|
$ 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.
|
|
|
|
|
|
## Related commands
|
|
|
|
* [volume create](volume_create.md)
|
|
* [volume ls](volume_ls.md)
|
|
* [volume inspect](volume_inspect.md)
|
|
* [volume rm](volume_rm.md)
|
|
* [Understand Data Volumes](https://docs.docker.com/engine/tutorials/dockervolumes/)
|
|
* [system df](system_df.md)
|
|
* [container prune](container_prune.md)
|
|
* [image prune](image_prune.md)
|
|
* [network prune](network_prune.md)
|
|
* [system prune](system_prune.md)
|