1podman-volume-prune(1)      General Commands Manual     podman-volume-prune(1)
2
3
4

NAME

6       podman-volume-prune - Remove all unused volumes
7
8

SYNOPSIS

10       podman volume prune [options]
11
12

DESCRIPTION

14       Removes  unused volumes. By default all unused volumes are removed, the
15       --filter flag can  be  used  to  filter  specific  volumes.  Users  are
16       prompted  to  confirm  the removal of all the unused volumes. To bypass
17       the confirmation, use the --force flag.
18
19

OPTIONS

21   --filter
22       Provide filter values.
23
24
25       The filters argument format is of key=value. If there is more than  one
26       filter, then pass multiple OPTIONS: --filter foo=bar --filter bif=baz.
27
28
29       Supported filters:
30
31
32       ┌────────────┬────────────────────────────┐
33       │Filter      │ Description                │
34       ├────────────┼────────────────────────────┤
35       │dangling    │ [Bool] Only remove volumes │
36       │            │ not referenced by any con‐ │
37       │            │ tainers                    │
38       ├────────────┼────────────────────────────┤
39       │driver      │ [String]  Only remove vol‐ │
40       │            │ umes with the given driver │
41       ├────────────┼────────────────────────────┤
42       │label       │ [String] Only remove  vol‐ │
43       │            │ umes, with (or without, in │
44       │            │ the case  of  label!=[...] │
45       │            │ is used) the specified la‐ │
46       │            │ bels.                      │
47       ├────────────┼────────────────────────────┤
48       │name        │ [String] Only remove  vol‐ │
49       │            │ ume with the given name    │
50       ├────────────┼────────────────────────────┤
51       │opt         │ [String]  Only remove vol‐ │
52       │            │ umes  created   with   the │
53       │            │ given options              │
54       ├────────────┼────────────────────────────┤
55       │scope       │ [String]  Only remove vol‐ │
56       │            │ umes with the given scope  │
57       ├────────────┼────────────────────────────┤
58       │until       │ [DateTime]   Only   remove │
59       │            │ volumes   created   before │
60       │            │ given timestamp.           │
61       ├────────────┼────────────────────────────┤
62       │after/since │ [Volume] Filter by volumes │
63       │            │ created  after  the  given │
64       │            │ VOLUME (name or tag)       │
65       └────────────┴────────────────────────────┘
66
67       The label filter accepts two formats.  One  is  the  label=key  or  la‐
68       bel=key=value,  which  removes  volumes  with the specified labels. The
69       other format is the label!=key or label!=key=value, which removes  vol‐
70       umes without the specified labels.
71
72
73       The  until filter can be Unix timestamps, date formatted timestamps, or
74       Go duration strings (e.g. 10m, 1h30m)  computed  relative  to  the  ma‐
75       chine’s time.
76
77
78   --force, -f
79       Do not prompt for confirmation.
80
81
82   --help
83       Print usage statement
84
85

EXAMPLES

87       $ podman volume prune
88
89       $ podman volume prune --force
90
91       $ podman volume prune --filter label=mylabel=mylabelvalue
92
93
94

SEE ALSO

96       podman(1), podman-volume(1)
97
98

HISTORY

100       November  2018,  Originally  compiled  by Urvashi Mohnani umohnani@red‐
101       hat.com ⟨mailto:umohnani@redhat.com⟩
102
103
104
105                                                        podman-volume-prune(1)