1podman-system-prune(1)()                              podman-system-prune(1)()
2
3
4

NAME

6       podman-system-prune  - Remove all unused pod, container, image and vol‐
7       ume data
8
9

SYNOPSIS

11       podman system prune [options]
12
13

DESCRIPTION

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

OPTIONS

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       ┌───────┬────────────────────────────┐
47Filter Description                
48       ├───────┼────────────────────────────┤
49label  │ Only remove containers and │
50       │       │ images, with (or  without, │
51       │       │ in   the   case   of   la‐ │
52       │       │ bel!=[...]  is  used)  the │
53       │       │ specified labels.          │
54       ├───────┼────────────────────────────┤
55until  │ 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

SEE ALSO

84       podman(1), podman-system(1)
85
86

HISTORY

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)()
Impressum