1podman-images(1)() podman-images(1)()
2
6 podman-images - List images in local storage
7
10 podman images [options]
11 podman image list [options]
14 podman image ls [options]
17
20 Displays locally stored images, their names, and their IDs.
21
24 --all, -a
25 Show all images (by default filter out the intermediate image layers).
26 The default is false.
27 --digests
30 Show image digests
31 --filter=filter, -f
34 Filter output based on conditions provided
35 Filters:
38 since=IMAGE
41 Filter on images created after the given IMAGE (name or tag).
42 before=IMAGE
45 Filter on images created before the given IMAGE (name or tag).
46 dangling=true|false
49 Show dangling images. Dangling images are a file system layer that
50 was used in a previous build of an image and is no longer referenced by
51 any active images. They are denoted with the tag, consume disk space
52 and serve no active purpose.
53 label
56 Filter by images labels key and/or value.
57 readonly=true|false
60 Show only read only images or Read/Write images. The default is to
61 show both. Read/Only images can be configured by modifying the "addi‐
62 tionalimagestores" in the /etc/containers/storage.conf file.
63 reference=
66 Filter by image name, specified as regular expressions.
67 --format=format
70 Change the default output format. This can be of a supported type like
71 'json' or a Go template. Valid placeholders for the Go template are
72 listed below:
73 ┌──────────────┬────────────────────────────┐
76 │Placeholder │ Description │
77 ├──────────────┼────────────────────────────┤
78 │.ID │ Image ID │
79 ├──────────────┼────────────────────────────┤
80 │.Repository │ Image repository │
81 ├──────────────┼────────────────────────────┤
82 │.Tag │ Image tag │
83 ├──────────────┼────────────────────────────┤
84 │.Digest │ Image digest │
85 ├──────────────┼────────────────────────────┤
86 │.CreatedSince │ Elapsed time since the │
87 │ │ image was cre‐ │
88 │ │ ated │
89 │ │ │
90 ├──────────────┼────────────────────────────┤
91 │.CreatedAt │ Time when the image was │
92 │ │ created │
93 ├──────────────┼────────────────────────────┤
94 │.Size │ Size of layer on disk │
95 ├──────────────┼────────────────────────────┤
96 │.History │ History of the image layer │
97 ├──────────────┼────────────────────────────┤
98 │ │ │
99 └──────────────┴────────────────────────────┘
100 --history
102 Display the history of image names. If an image gets re-tagged or
103 untagged, then the image name history gets prepended (latest image
104 first). This is especially useful when undoing a tag operation or an
105 image does not contain any name because it has been untagged.
106 --noheading, -n
109 Omit the table headings from the listing of images.
110 --no-trunc
113 Do not truncate output.
114 --quiet, -q
117 Lists only the image IDs.
118 --sort=sort
121 Sort by created, id, repository, size or tag (default: created)
122
125 # podman images
126 REPOSITORY TAG IMAGE ID CREATED SIZE
127 docker.io/kubernetes/pause latest e3d42bcaf643 3 years ago 251 kB
128 <none> <none> ebb91b73692b 4 weeks ago 27.2 MB
129 docker.io/library/ubuntu latest 4526339ae51c 6 weeks ago 126 MB
130 # podman images --quiet
134 e3d42bcaf643
135 ebb91b73692b
136 4526339ae51c
137 # podman images --noheading
141 docker.io/kubernetes/pause latest e3d42bcaf643 3 years ago 251 kB
142 <none> <none> ebb91b73692b 4 weeks ago 27.2 MB
143 docker.io/library/ubuntu latest 4526339ae51c 6 weeks ago 126 MB
144 # podman images --no-trunc
148 REPOSITORY TAG IMAGE ID CREATED SIZE
149 docker.io/kubernetes/pause latest sha256:e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27 3 years ago 251 kB
150 <none> <none> sha256:ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9 4 weeks ago 27.2 MB
151 docker.io/library/ubuntu latest sha256:4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a 6 weeks ago 126 MB
152 # podman images --format "table {{.ID}} {{.Repository}} {{.Tag}}"
156 IMAGE ID REPOSITORY TAG
157 e3d42bcaf643 docker.io/kubernetes/pause latest
158 ebb91b73692b <none> <none>
159 4526339ae51c docker.io/library/ubuntu latest
160 # podman images --filter dangling=true
164 REPOSITORY TAG IMAGE ID CREATED SIZE
165 <none> <none> ebb91b73692b 4 weeks ago 27.2 MB
166 # podman images --format json
170 [
171 {
172 "id": "e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27",
173 "names": [
174 "docker.io/kubernetes/pause:latest"
175 ],
176 "digest": "sha256:0aecf73ff86844324847883f2e916d3f6984c5fae3c2f23e91d66f549fe7d423",
177 "created": "2014-07-19T07:02:32.267701596Z",
178 "size": 250665
179 },
180 {
181 "id": "ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9",
182 "names": [
183 "\u003cnone\u003e"
184 ],
185 "digest": "sha256:ba7e4091d27e8114a205003ca6a768905c3395d961624a2c78873d9526461032",
186 "created": "2017-10-26T03:07:22.796184288Z",
187 "size": 27170520
188 },
189 {
190 "id": "4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a",
191 "names": [
192 "docker.io/library/ubuntu:latest"
193 ],
194 "digest": "sha256:193f7734ddd68e0fb24ba9af8c2b673aecb0227b026871f8e932dab45add7753",
195 "created": "2017-10-10T20:59:05.10196344Z",
196 "size": 126085200
197 }
198 ]
199 # podman images --sort repository
203 REPOSITORY TAG IMAGE ID CREATED SIZE
204 <none> <none> 2460217d76fc About a minute ago 4.41 MB
205 docker.io/library/alpine latest 3fd9065eaf02 5 months ago 4.41 MB
206 localhost/myapp latest b2e0ad03474a About a minute ago 4.41 MB
207 registry.access.redhat.com/rhel7 latest 7a840db7f020 2 weeks ago 211 MB
208 registry.fedoraproject.org/fedora 27 801894bc0e43 6 weeks ago 246 MB
209 # podman images
213 REPOSITORY TAG IMAGE ID CREATED SIZE
214 localhost/test latest 18f0c080cd72 4 seconds ago 4.42 MB
215 docker.io/library/alpine latest 3fd9065eaf02 5 months ago 4.41 MB
216 # podman images -a
217 REPOSITORY TAG IMAGE ID CREATED SIZE
218 localhost/test latest 18f0c080cd72 6 seconds ago 4.42 MB
219 <none> <none> 270e70dc54c0 7 seconds ago 4.42 MB
220 <none> <none> 4ed6fbe43414 8 seconds ago 4.41 MB
221 <none> <none> 6b0df8e71508 8 seconds ago 4.41 MB
222 docker.io/library/alpine latest 3fd9065eaf02 5 months ago 4.41 MB
223
227 podman(1), containers-storage.conf(5)
228
231 March 2017, Originally compiled by Dan Walsh dwalsh@redhat.com
232 ⟨mailto:dwalsh@redhat.com⟩
233 podman-images(1)()