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       │label       │ Only  remove volumes, with │
36       │            │ (or without, in  the  case │
37       │            │ of  label!=[...]  is used) │
38       │            │ the specified labels.      │
39       ├────────────┼────────────────────────────┤
40       │until       │ Only remove  volumes  cre‐ │
41       │            │ ated  before  given  time‐ │
42       │            │ stamp.                     │
43       ├────────────┼────────────────────────────┤
44       │after/since │ Filter by volumes  created │
45       │            │ after   the  given  VOLUME │
46       │            │ (name or tag)              │
47       └────────────┴────────────────────────────┘
48
49       The label filter accepts two formats.  One  is  the  label=key  or  la‐
50       bel=key=value,  which  removes  volumes  with the specified labels. The
51       other format is the label!=key or label!=key=value, which removes  vol‐
52       umes without the specified labels.
53
54
55       The  until filter can be Unix timestamps, date formatted timestamps, or
56       Go duration strings (e.g. 10m, 1h30m)  computed  relative  to  the  ma‐
57       chine’s time.
58
59
60   --force, -f
61       Do not prompt for confirmation.
62
63
64   --help
65       Print usage statement
66
67

EXAMPLES

69              $ podman volume prune
70
71              $ podman volume prune --force
72
73              $ podman volume prune --filter label=mylabel=mylabelvalue
74
75
76

SEE ALSO

78       podman(1), podman-volume(1)
79
80

HISTORY

82       November  2018,  Originally  compiled  by Urvashi Mohnani umohnani@red‐
83       hat.com ⟨mailto:umohnani@redhat.com⟩
84
85
86
87                                                        podman-volume-prune(1)