1podman-system-prune(1)() podman-system-prune(1)()
2
3
4
6 podman-system-prune - Remove all unused pod, container, image and vol‐
7 ume data
8
9
11 podman system prune [options]
12
13
15 podman system prune removes all unused containers (both dangling and
16 unreferenced), pods and optionally, volumes from local storage.
17
18
19 With the --all option, you can delete all unused images. Unused images
20 are dangling images as well as any image that does not have any con‐
21 tainers based on it.
22
23
24 By default, volumes are not removed to prevent important data from be‐
25 ing deleted if there is currently no container using the volume. Use
26 the --volumes flag when running the command to prune volumes as well.
27
28
30 --all, -a
31 Recursively remove all unused pod, container, image and volume data
32 (Maximum 50 iterations.)
33
34
35 --filter=filters
36 Provide filter values.
37
38
39 The filters argument format is of key=value. If there is more than one
40 filter, then pass multiple OPTIONS: --filter foo=bar --filter bif=baz.
41
42
43 Supported filters:
44
45
46 ┌───────┬────────────────────────────┐
47 │Filter │ Description │
48 ├───────┼────────────────────────────┤
49 │label │ Only remove containers and │
50 │ │ images, with (or without, │
51 │ │ in the case of la‐ │
52 │ │ bel!=[...] is used) the │
53 │ │ specified labels. │
54 ├───────┼────────────────────────────┤
55 │until │ Only remove containers and │
56 │ │ images created before │
57 │ │ given timestamp. │
58 └───────┴────────────────────────────┘
59
60 The label filter accepts two formats. One is the label=key or la‐
61 bel=key=value, which removes containers and images with the specified
62 labels. The other format is the label!=key or label!=key=value, which
63 removes containers and images without the specified labels.
64
65
66 The until filter can be Unix timestamps, date formatted timestamps, or
67 Go duration strings (e.g. 10m, 1h30m) computed relative to the ma‐
68 chine’s time.
69
70
71 --force, -f
72 Do not prompt for confirmation
73
74
75 --help, -h
76 Print usage statement
77
78
79 --volumes
80 Prune volumes currently unused by any container
81
82
84 podman(1), podman-system(1)
85
86
88 February 2019, Originally compiled by Dan Walsh (dwalsh at redhat dot
89 com) December 2020, converted filter information from docs.docker.com
90 documentation by Dan Walsh (dwalsh at redhat dot com)
91
92
93
94 podman-system-prune(1)()