moby--moby/docs/reference/commandline/volume_rm.md

<!--[metadata]>
+++
title = "volume rm"
description = "the volume rm command description and usage"
keywords = ["volume, rm"]
[menu.main]
parent = "smn_cli"
+++
<![end-metadata]-->

# volume rm

```markdown
Usage:  docker volume rm [OPTIONS] VOLUME [VOLUME...]

Remove one or more volumes

Aliases:
  rm, remove

Options:
  -f, --force  Force the removal of one or more volumes
      --help   Print usage
```

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

    $ docker volume rm hello
    hello

## Related information

* [volume create](volume_create.md)
* [volume inspect](volume_inspect.md)
* [volume ls](volume_ls.md)
* [Understand Data Volumes](../../tutorials/dockervolumes.md)
Add volume API/CLI Signed-off-by: Brian Goff <cpuguy83@gmail.com> 2015-06-12 09:25:32 -04:00			`<!--[metadata]>`
			`+++`
Enabled GitHub Flavored Markdown GitHub flavored markdown is now supported for links and images. Also, ran LinkChecker and FileResolver. Yay! Fixes from Spider check Output for docker/docker now goes into engine directory Signed-off-by: Mary Anthony <mary@docker.com> 2015-10-09 16:50:41 -07:00			`title = "volume rm"`
Add volume API/CLI Signed-off-by: Brian Goff <cpuguy83@gmail.com> 2015-06-12 09:25:32 -04:00			`description = "the volume rm command description and usage"`
			`keywords = ["volume, rm"]`
			`[menu.main]`
			`parent = "smn_cli"`
			`+++`
			`<![end-metadata]-->`

			`# volume rm`

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 20:43:18 +02:00			```markdown
Add `--force` in `docker volume rm` to fix out-of-band volume driver deletion This fix tries to address the issue in raised #23367 where an out-of-band volume driver deletion leaves some data in docker. This prevent the reuse of deleted volume names (by out-of-band volume driver like flocker). This fix adds a `--force` field in `docker volume rm` to forcefully purge the data of the volume that has already been deleted. Related documentations have been updated. This fix is tested manually with flocker, as is specified in #23367. An integration test has also been added for the scenario described. This fix fixes #23367. Signed-off-by: Yong Tang <yong.tang.github@outlook.com> 2016-06-10 07:40:09 -07:00			`Usage: docker volume rm [OPTIONS] VOLUME [VOLUME...]`
Add volume API/CLI Signed-off-by: Brian Goff <cpuguy83@gmail.com> 2015-06-12 09:25:32 -04:00
update command description in CLI Signed-off-by: allencloud <allen.sun@daocloud.io> 2016-07-30 01:41:52 +08:00			`Remove one or more volumes`
Add volume API/CLI Signed-off-by: Brian Goff <cpuguy83@gmail.com> 2015-06-12 09:25:32 -04:00
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 20:43:18 +02:00			`Aliases:`
			`rm, remove`

			`Options:`
Add `--force` in `docker volume rm` to fix out-of-band volume driver deletion This fix tries to address the issue in raised #23367 where an out-of-band volume driver deletion leaves some data in docker. This prevent the reuse of deleted volume names (by out-of-band volume driver like flocker). This fix adds a `--force` field in `docker volume rm` to forcefully purge the data of the volume that has already been deleted. Related documentations have been updated. This fix is tested manually with flocker, as is specified in #23367. An integration test has also been added for the scenario described. This fix fixes #23367. Signed-off-by: Yong Tang <yong.tang.github@outlook.com> 2016-06-10 07:40:09 -07:00			`-f, --force Force the removal of one or more volumes`
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 20:43:18 +02:00			`--help Print usage`
			```
Add volume API/CLI Signed-off-by: Brian Goff <cpuguy83@gmail.com> 2015-06-12 09:25:32 -04:00
update command description in CLI Signed-off-by: allencloud <allen.sun@daocloud.io> 2016-07-30 01:41:52 +08:00			`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
Fixing wrong volume doc format Signed-off-by: Kai Qiang Wu(Kennan) <wkqwu@cn.ibm.com> 2015-11-09 02:17:50 -06:00			`$ docker volume rm hello`
			`hello`
add a section to each volume page Signed-off-by: ozlerhakan <hakan.ozler@kodcu.com> 2016-02-18 21:52:15 +02:00
			`## Related information`

			`* [volume create](volume_create.md)`
			`* [volume inspect](volume_inspect.md)`
			`* [volume ls](volume_ls.md)`
surfacing Learn by example topics to top level of Docker Engine docs fixing links after moving surfacing tutorials fixing more links for the newly located tutorials Signed-off-by: Victoria Bialas <victoria.bialas@docker.com> 2016-06-13 11:08:11 -07:00			`* [Understand Data Volumes](../../tutorials/dockervolumes.md)`