.nh
.TH podman-volume-prune 1
.SH NAME
.PP
podman-volume-prune - Remove all unused volumes

.SH SYNOPSIS
.PP
\fBpodman volume prune\fP [\fIoptions\fP]

.SH DESCRIPTION
.PP
Removes unused volumes. By default all unused volumes will be removed, the \fB--filter\fP flag can
be used to filter specific volumes. You will be prompted to confirm the removal of all the
unused volumes. To bypass the confirmation, use the \fB--force\fP flag.

.SH OPTIONS
.SS \fB--filter\fP
.PP
Provide filter values.

.PP
The \fIfilters\fP argument format is of \fB\fCkey=value\fR\&. If there is more than one \fIfilter\fP, then pass multiple OPTIONS: \fB--filter\fP \fIfoo=bar\fP \fB--filter\fP \fIbif=baz\fP\&.

.PP
Supported filters:

.TS
allbox;
l l 
l l .
\fB\fCFilter\fR	\fB\fCDescription\fR
\fIlabel\fP	T{
Only remove volumes, with (or without, in the case of label!=[...] is used) the specified labels.
T}
\fIuntil\fP	T{
Only remove volumes created before given timestamp.
T}
.TE

.PP
The \fB\fClabel\fR \fIfilter\fP accepts two formats. One is the \fB\fClabel\fR=\fIkey\fP or \fB\fClabel\fR=\fIkey\fP=\fIvalue\fP, which removes volumes with the specified labels. The other format is the \fB\fClabel!\fR=\fIkey\fP or \fB\fClabel!\fR=\fIkey\fP=\fIvalue\fP, which removes volumes without the specified labels.

.PP
The \fB\fCuntil\fR \fIfilter\fP can be Unix timestamps, date formatted timestamps, or Go duration strings (e.g. 10m, 1h30m) computed relative to the machine’s time.

.SS \fB--force\fP, \fB-f\fP
.PP
Do not prompt for confirmation.

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

.SH EXAMPLES
.PP
.RS

.nf
$ podman volume prune

$ podman volume prune --force

$ podman volume prune --filter label=mylabel=mylabelvalue

.fi
.RE

.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]