1podman-rmi(1)() podman-rmi(1)()
2
3
4
6 podman-rmi - Removes one or more locally stored images
7
8
10 podman rmi [options] image [...]
11
12
13 podman image rm [options] image [...]
14
15
17 Removes one or more locally stored images. Passing an argument image
18 deletes it, along with any of its dangling parent images. A dangling
19 image is an image without a tag and without being referenced by another
20 image.
21
22
23 Note: To delete an image from a remote registry, use the skopeo delete
24 command. Some registries do not allow users to delete an image via a
25 CLI remotely.
26
27
29 --all, -a
30 Remove all images in the local storage.
31
32
33 --force, -f
34 This option will cause podman to remove all containers that are using
35 the image before removing the image from the system.
36
37
38 Remove an image by its short ID
39
40
41 $ podman rmi c0ed59d05ff7
42
43
44
45 Remove an image and its associated containers.
46
47
48 $ podman rmi --force imageID
49
50
51
52 Remove multiple images by their shortened IDs.
53
54
55 $ podman rmi c4dfb1609ee2 93fd78260bd1 c0ed59d05ff7
56
57
58
59 Remove all images and containers.
60
61
62 $ podman rmi -a -f
63
64
65
67 0 All specified images removed
68
69
70 1 One of the specified images did not exist, and no other failures
71
72
73 2 One of the specified images has child images or is being used by a
74 container
75
76
77 125 The command fails for any other reason
78
79
81 podman(1), skopeo-delete(1)
82
83
85 March 2017, Originally compiled by Dan Walsh dwalsh@redhat.com
86 ⟨mailto:dwalsh@redhat.com⟩
87
88
89
90 podman-rmi(1)()