1podman-rmi(1)()                                                podman-rmi(1)()
2
3
4

NAME

6       podman-rmi - Removes one or more locally stored images
7
8

SYNOPSIS

10       podman rmi [options] image [...]
11
12
13       podman image rm [options] image [...]
14
15

DESCRIPTION

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

OPTIONS

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   --ignore, -i
39       If a specified image does not exist in the local storage, ignore it and
40       do not throw an error.
41
42
43       Remove an image by its short ID
44
45
46              $ podman rmi c0ed59d05ff7
47
48
49
50       Remove an image and its associated containers.
51
52
53              $ podman rmi --force imageID
54
55
56
57       Remove multiple images by their shortened IDs.
58
59
60              $ podman rmi c4dfb1609ee2 93fd78260bd1 c0ed59d05ff7
61
62
63
64       Remove all images and containers.
65
66
67              $ podman rmi -a -f
68
69
70
71       Remove an absent image with and without the --ignore flag.
72
73
74              $ podman rmi --ignore nothing
75              $ podman rmi nothing
76              Error: nothing: image not known
77
78
79
80

Exit Status

82       0   All specified images removed
83
84
85       1   One of the specified images did not exist, and no other failures
86
87
88       2   One of the specified images has child images or is being used by  a
89       container
90
91
92       125 The command fails for any other reason
93
94

SEE ALSO

96       podman(1), skopeo-delete(1)
97
98

HISTORY

100       March   2017,   Originally  compiled  by  Dan  Walsh  dwalsh@redhat.com
101       ⟨mailto:dwalsh@redhat.com⟩
102
103
104
105                                                               podman-rmi(1)()