summaryrefslogtreecommitdiff
path: root/docs/podman-image-prune.1.md
blob: df912c3809eacfca890f79a0670179b25724b7ea (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
% PODMAN(1) Podman Man Pages
% Brent Baude
% December 2018
# NAME
podman-image-prune - Remove all unused images

# SYNOPSIS
**podman image prune**
[**-a**|**--all**]
[**-h**|**--help**]

# DESCRIPTION
**podman image prune** removes all dangling images from local storage. With the `all` option,
you can delete all unused images.  Unused images are dangling images as well as any image that
does not have any containers based on it.

## OPTIONS
**--all, -a**

Remove dangling images and images that have no associated containers.

## Examples ##

Remove all dangling images from local storage
```
$ sudo podman image prune
f3e20dc537fb04cb51672a5cb6fdf2292e61d411315549391a0d1f64e4e3097e
324a7a3b2e0135f4226ffdd473e4099fd9e477a74230cdc35de69e84c0f9d907
```

Remove all unused images from local storage
```
$ sudo podman image prune -a
f3e20dc537fb04cb51672a5cb6fdf2292e61d411315549391a0d1f64e4e3097e
324a7a3b2e0135f4226ffdd473e4099fd9e477a74230cdc35de69e84c0f9d907
6125002719feb1ddf3030acab1df6156da7ce0e78e571e9b6e9c250424d6220c
91e732da5657264c6f4641b8d0c4001c218ae6c1adb9dcef33ad00cafd37d8b6
e4e5109420323221f170627c138817770fb64832da7d8fe2babd863148287fca
77a57fa8285e9656dbb7b23d9efa837a106957409ddd702f995605af27a45ebe

```

## SEE ALSO
podman(1), podman-images

# HISTORY
December 2018, Originally compiled by Brent Baude (bbaude at redhat dot com)