2016-10-14 18:30:36 -04:00
|
|
|
---
|
|
|
|
title: "volume rm"
|
|
|
|
description: "the volume rm command description and usage"
|
2016-11-03 18:48:30 -04:00
|
|
|
keywords: "volume, rm"
|
2016-10-14 18:30:36 -04:00
|
|
|
---
|
|
|
|
|
2017-10-04 13:03:55 -04:00
|
|
|
<!-- This file is maintained within the docker/cli GitHub
|
2017-07-28 13:28:23 -04:00
|
|
|
repository at https://github.com/docker/cli/. Make all
|
2016-10-19 13:25:45 -04:00
|
|
|
pull requests against that repo. If you see this file in
|
|
|
|
another repository, consider it read-only there, as it will
|
|
|
|
periodically be overwritten by the definitive file. Pull
|
|
|
|
requests which include edits to this file in other repositories
|
|
|
|
will be rejected.
|
|
|
|
-->
|
2015-06-12 09:25:32 -04:00
|
|
|
|
|
|
|
# volume rm
|
|
|
|
|
2016-07-07 14:43:18 -04:00
|
|
|
```markdown
|
2016-06-10 10:40:09 -04:00
|
|
|
Usage: docker volume rm [OPTIONS] VOLUME [VOLUME...]
|
2015-06-12 09:25:32 -04:00
|
|
|
|
2016-07-29 13:41:52 -04:00
|
|
|
Remove one or more volumes
|
2015-06-12 09:25:32 -04:00
|
|
|
|
2016-07-07 14:43:18 -04:00
|
|
|
Aliases:
|
|
|
|
rm, remove
|
|
|
|
|
|
|
|
Options:
|
2016-06-10 10:40:09 -04:00
|
|
|
-f, --force Force the removal of one or more volumes
|
2016-07-07 14:43:18 -04:00
|
|
|
--help Print usage
|
|
|
|
```
|
2015-06-12 09:25:32 -04:00
|
|
|
|
2017-02-07 18:42:48 -05:00
|
|
|
## Description
|
|
|
|
|
2016-07-29 13:41:52 -04:00
|
|
|
Remove one or more volumes. You cannot remove a volume that is in use by a container.
|
2015-06-12 09:25:32 -04:00
|
|
|
|
2017-02-07 18:42:48 -05:00
|
|
|
## Examples
|
|
|
|
|
|
|
|
```bash
|
|
|
|
$ docker volume rm hello
|
|
|
|
hello
|
|
|
|
```
|
2016-02-18 14:52:15 -05:00
|
|
|
|
2017-02-07 18:42:48 -05:00
|
|
|
## Related commands
|
2016-02-18 14:52:15 -05:00
|
|
|
|
|
|
|
* [volume create](volume_create.md)
|
|
|
|
* [volume inspect](volume_inspect.md)
|
|
|
|
* [volume ls](volume_ls.md)
|
2016-10-18 06:50:11 -04:00
|
|
|
* [volume prune](volume_prune.md)
|
2016-10-17 12:04:52 -04:00
|
|
|
* [Understand Data Volumes](https://docs.docker.com/engine/tutorials/dockervolumes/)
|