DockerCLI/docs/reference/commandline/volume_rm.md

# volume rm

<!---MARKER_GEN_START-->

Remove one or more volumes. You cannot remove a volume that is in use by a container.


### Aliases

`docker volume rm`, `docker volume remove`

### Options

| Name            | Type   | Default | Description                              |
|:----------------|:-------|:--------|:-----------------------------------------|
| `-f`, `--force` | `bool` |         | Force the removal of one or more volumes |


<!---MARKER_GEN_END-->

## Description

Remove one or more volumes. You can't remove a volume that's in use by a container.

## Examples

```console
$ docker volume rm hello

hello
```

## Related commands

* [volume create](volume_create.md)
* [volume inspect](volume_inspect.md)
* [volume ls](volume_ls.md)
* [volume prune](volume_prune.md)
* [Understand Data Volumes](https://docs.docker.com/storage/volumes/)
Add volume API/CLI Signed-off-by: Brian Goff <cpuguy83@gmail.com> 2015-06-12 09:25:32 -04:00			`# volume rm`

docs: generate markdown Keep frontmatter for docker, dockerd and index markdown files. Also needs to move cli.md > docker.md before generation and then move it back because cli.md is needed for yaml generation on docs website: https://github.com/docker/cli/pull/3924#discussion_r1059986605 Signed-off-by: Kevin Alvarez <crazy-max@users.noreply.github.com> Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2023-01-06 13:04:05 -05:00			`<!---MARKER_GEN_START-->`

			`Remove one or more volumes. You cannot remove a volume that is in use by a container.`
Add volume API/CLI Signed-off-by: Brian Goff <cpuguy83@gmail.com> 2015-06-12 09:25:32 -04:00

docs: generate markdown Keep frontmatter for docker, dockerd and index markdown files. Also needs to move cli.md > docker.md before generation and then move it back because cli.md is needed for yaml generation on docs website: https://github.com/docker/cli/pull/3924#discussion_r1059986605 Signed-off-by: Kevin Alvarez <crazy-max@users.noreply.github.com> Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2023-01-06 13:04:05 -05:00			`### Aliases`
Updates on cli reference documentation - Update ps with `--last` flag - Update commands with current output - Make sure hugo does not detect the wrong language - Update usage for `tag` command to be more coherent with the other ones Signed-off-by: Vincent Demeester <vincent@sbr.pm> 2016-07-07 14:43:18 -04:00
docs: generate markdown Keep frontmatter for docker, dockerd and index markdown files. Also needs to move cli.md > docker.md before generation and then move it back because cli.md is needed for yaml generation on docs website: https://github.com/docker/cli/pull/3924#discussion_r1059986605 Signed-off-by: Kevin Alvarez <crazy-max@users.noreply.github.com> Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2023-01-06 13:04:05 -05:00			`docker volume rm`, `docker volume remove`

			`### Options`

chore: regenerate docs Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com> 2024-07-03 02:29:57 -04:00			`\| Name \| Type \| Default \| Description \|`
			`\|:----------------\|:-------\|:--------\|:-----------------------------------------\|`
			\| `-f`, `--force` \| `bool` \| \| Force the removal of one or more volumes \|
docs: generate markdown Keep frontmatter for docker, dockerd and index markdown files. Also needs to move cli.md > docker.md before generation and then move it back because cli.md is needed for yaml generation on docs website: https://github.com/docker/cli/pull/3924#discussion_r1059986605 Signed-off-by: Kevin Alvarez <crazy-max@users.noreply.github.com> Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2023-01-06 13:04:05 -05:00

			`<!---MARKER_GEN_END-->`
Add volume API/CLI Signed-off-by: Brian Goff <cpuguy83@gmail.com> 2015-06-12 09:25:32 -04:00
Standardized formatting of CLI reference commands Command name should be a H1 Only Description, Examples, and Related Commands should be H2 Changed 'Related information' heading to 'Related commands' since 99% it is only linking commands Added some examples where relevant Signed-off-by: Misty Stanley-Jones <misty@docker.com> 2017-02-07 18:42:48 -05:00			`## Description`

docs: minor editorial improvements, typo fixes Signed-off-by: David Karlsson <35727626+dvdksn@users.noreply.github.com> 2023-12-13 09:16:56 -05:00			`Remove one or more volumes. You can't remove a volume that's in use by a container.`
Add volume API/CLI Signed-off-by: Brian Goff <cpuguy83@gmail.com> 2015-06-12 09:25:32 -04:00
Standardized formatting of CLI reference commands Command name should be a H1 Only Description, Examples, and Related Commands should be H2 Changed 'Related information' heading to 'Related commands' since 99% it is only linking commands Added some examples where relevant Signed-off-by: Misty Stanley-Jones <misty@docker.com> 2017-02-07 18:42:48 -05:00			`## Examples`

docs: use "console" code-hint for shell examples This replaces the use of bash where suitable, to allow easier copy/pasting of shell examples without copying the prompt or process output. Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2021-08-21 08:54:14 -04:00			```console
reference docs: fix broken links and markdown touch-ups - fix various broken links - fix incorrect anchors - updated links for content that moved, so that no redirect to the new location is needed. - touched-up Markdown; - re-format some JSON output - add blank line betweeen command and command output - format "note" blocks Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2020-04-19 09:43:08 -04:00			`$ docker volume rm hello`

			`hello`
Standardized formatting of CLI reference commands Command name should be a H1 Only Description, Examples, and Related Commands should be H2 Changed 'Related information' heading to 'Related commands' since 99% it is only linking commands Added some examples where relevant Signed-off-by: Misty Stanley-Jones <misty@docker.com> 2017-02-07 18:42:48 -05:00			```
add a section to each volume page Signed-off-by: ozlerhakan <hakan.ozler@kodcu.com> 2016-02-18 14:52:15 -05:00
Standardized formatting of CLI reference commands Command name should be a H1 Only Description, Examples, and Related Commands should be H2 Changed 'Related information' heading to 'Related commands' since 99% it is only linking commands Added some examples where relevant Signed-off-by: Misty Stanley-Jones <misty@docker.com> 2017-02-07 18:42:48 -05:00			`## Related commands`
add a section to each volume page Signed-off-by: ozlerhakan <hakan.ozler@kodcu.com> 2016-02-18 14:52:15 -05:00
			`* [volume create](volume_create.md)`
			`* [volume inspect](volume_inspect.md)`
			`* [volume ls](volume_ls.md)`
Fix typs from go to Go Signed-off-by: yuexiao-wang <wang.yuexiao@zte.com.cn> 2016-10-18 06:50:11 -04:00			`* [volume prune](volume_prune.md)`
reference docs: fix broken links and markdown touch-ups - fix various broken links - fix incorrect anchors - updated links for content that moved, so that no redirect to the new location is needed. - touched-up Markdown; - re-format some JSON output - add blank line betweeen command and command output - format "note" blocks Signed-off-by: Sebastiaan van Stijn <github@gone.nl> 2020-04-19 09:43:08 -04:00			`* [Understand Data Volumes](https://docs.docker.com/storage/volumes/)`