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
25 being 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 --filter flag format is of “key=value”. If there is more than one
40 filter, then pass multiple flags (e.g., --filter "foo=bar" --filter
41 "bif=baz")
42
43
44 Supported filters:
45
46
47 · until (timestamp) - only remove containers and images created
48 before given timestamp
49
50 · label (label=key, label=key=value, label!=key, or
51 label!=key=value) - only remove containers and images, with
52 (or without, in case label!=... is used) the specified labels.
53
54
55
56 The until filter can be Unix timestamps, date formatted timestamps, or
57 Go duration strings (e.g. 10m, 1h30m) computed relative to the
58 machine’s time.
59
60
61 The label filter accepts two formats. One is the label=... (label=key
62 or label=key=value), which removes containers and images with the spec‐
63 ified labels. The other format is the label!=... (label!=key or
64 label!=key=value), which removes containers and images without the
65 specified labels.
66
67
68 --force, -f
69 Do not prompt for confirmation
70
71
72 --help, -h
73 Print usage statement
74
75
76 --volumes
77 Prune volumes currently unused by any container
78
79
81 podman(1), podman-image-prune(1), podman-container-prune(1), pod‐
82 man-pod-prune(1), podman-volume-prune(1)
83
84
86 February 2019, Originally compiled by Dan Walsh (dwalsh at redhat dot
87 com) December 2020, converted filter information from docs.docker.com
88 documentation by Dan Walsh (dwalsh at redhat dot com)
89
90
91
92 podman-system-prune(1)()