.nh
.TH podman-volume-rm 1
.SH NAME
.PP
podman-volume-rm - Remove one or more volumes

.SH SYNOPSIS
.PP
\fBpodman volume rm\fP [\fIoptions\fP] \fIvolume\fP [...]

.SH DESCRIPTION
.PP
Removes one or more volumes. Only volumes that are not being used are removed.
If a volume is being used by a container, an error is returned unless the \fB--force\fP
flag is being used. To remove all volumes, use the \fB--all\fP flag.
Volumes can be removed individually by providing their full name or a unique partial name.

.SH OPTIONS
.SS \fB--all\fP, \fB-a\fP
.PP
Remove all volumes.

.SS \fB--force\fP, \fB-f\fP
.PP
Remove a volume by force.
If it is being used by containers, the containers are removed first.

.SS \fB--help\fP
.PP
Print usage statement

.SS \fB--time\fP, \fB-t\fP=\fIseconds\fP
.PP
Seconds to wait before forcibly stopping running containers that are using the specified volume. The --force option must be specified to use the --time option. Use -1 for infinite wait.

.SH EXAMPLES
.PP
Remove multiple specified volumes.

.EX
$ podman volume rm myvol1 myvol2
.EE

.PP
Remove all volumes.

.EX
$ podman volume rm --all
.EE

.PP
Remove the specified volume even if it is in use. Note, this removes all containers using the volume.

.EX
$ podman volume rm --force myvol
.EE

.SH Exit Status
.PP
\fB0\fP   All specified volumes removed

.PP
\fB1\fP   One of the specified volumes did not exist, and no other failures

.PP
\fB2\fP   One of the specified volumes is being used by a container

.PP
\fB125\fP The command fails for any other reason

.SH SEE ALSO
.PP
\fBpodman(1)\fP, \fBpodman-volume(1)\fP

.SH HISTORY
.PP
November 2018, Originally compiled by Urvashi Mohnani umohnani@redhat.com
\[la]mailto:umohnani@redhat.com\[ra]