1podman-images(1) General Commands Manual podman-images(1)
2
6 podman-images - List images in local storage
7
10 podman images [options] [image]
11 podman image list [options] [image]
14 podman image ls [options] [image]
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, -f=filter
34 Provide filter values.
35 The filters argument format is of key=value or key!=value. If there is
38 more than one filter, then pass multiple OPTIONS: --filter foo=bar
39 --filter bif=baz.
40 Supported filters:
43 ┌─────────────┬────────────────────────────┐
46 │Filter │ Description │
47 ├─────────────┼────────────────────────────┤
48 │id │ Filter by image ID. │
49 ├─────────────┼────────────────────────────┤
50 │before │ Filter by images created │
51 │ │ before the given IMAGE │
52 │ │ (name or tag). │
53 ├─────────────┼────────────────────────────┤
54 │containers │ Filter by images with a │
55 │ │ running container. │
56 ├─────────────┼────────────────────────────┤
57 │dangling │ Filter by dangling (un‐ │
58 │ │ used) images. │
59 ├─────────────┼────────────────────────────┤
60 │digest │ Filter by digest. │
61 ├─────────────┼────────────────────────────┤
62 │intermediate │ Filter by images that are │
63 │ │ dangling and have no chil‐ │
64 │ │ dren │
65 ├─────────────┼────────────────────────────┤
66 │label │ Filter by images with (or │
67 │ │ without, in the case of │
68 │ │ label!=[...] is used) the │
69 │ │ specified labels. │
70 ├─────────────┼────────────────────────────┤
71 │manifest │ Filter by images that are │
72 │ │ manifest lists. │
73 ├─────────────┼────────────────────────────┤
74 │readonly │ Filter by read-only or │
75 │ │ read/write images. │
76 ├─────────────┼────────────────────────────┤
77 │reference │ Filter by image name. │
78 ├─────────────┼────────────────────────────┤
79 │after/since │ Filter by images created │
80 │ │ after the given IMAGE │
81 │ │ (name or tag). │
82 ├─────────────┼────────────────────────────┤
83 │until │ Filter by images created │
84 │ │ until the given duration │
85 │ │ or time. │
86 └─────────────┴────────────────────────────┘
87 The id filter accepts the image ID string.
89 The before filter accepts formats: <image-name>[:<tag>], <image id> or
92 <image@digest>.
93 The containers filter shows images that have a running container based
96 on that image.
97 The dangling filter shows images that are taking up disk space and
100 serve no purpose. Dangling image is a file system layer that was used
101 in a previous build of an image and is no longer referenced by any im‐
102 age. They are denoted with the <none> tag, consume disk space and serve
103 no active purpose.
104 The digest filter accepts the image digest string.
107 The intermediate filter shows images that are dangling and have no
110 children.
111 The label filter accepts two formats. One is the label=key or la‐
114 bel=key=value, which shows images with the specified labels. The other
115 format is the label!=key or label!=key=value, which shows images with‐
116 out the specified labels.
117 The manifest filter shows images that are manifest lists.
120 The readonly filter shows, as a default, both read-only and read/write
123 images. Read-only images can be configured by modifying the addition‐
124 alimagestores in the /etc/containers/storage.conf file.
125 The reference filter accepts the pattern of an image reference <image-
128 name>[:<tag>].
129 The after or since filter accepts formats: <image-name>[:<tag>], <image
132 id> or <image@digest>.
133 The until filter accepts formats: golang duration, RFC3339 time, or a
136 Unix timestamp and shows all images that are created until that time.
137 --format=format
140 Change the default output format. This can be of a supported type like
141 'json' or a Go template. Valid placeholders for the Go template are
142 listed below:
143 ┌──────────────┬───────────────────────────────┐
146 │Placeholder │ Description │
147 ├──────────────┼───────────────────────────────┤
148 │.Containers │ Number of containers using │
149 │ │ this image │
150 ├──────────────┼───────────────────────────────┤
151 │.Created │ Elapsed time since the image │
152 │ │ was created │
153 ├──────────────┼───────────────────────────────┤
154 │.CreatedAt │ Time when the image was cre‐ │
155 │ │ ated, YYYY-MM-DD HH:MM:SS │
156 │ │ +nnnn │
157 ├──────────────┼───────────────────────────────┤
158 │.CreatedSince │ Same as .Created │
159 ├──────────────┼───────────────────────────────┤
160 │.CreatedTime │ Same as .CreatedAt │
161 ├──────────────┼───────────────────────────────┤
162 │.Dangling │ Same as .IsDangling │
163 ├──────────────┼───────────────────────────────┤
164 │.Digest │ Image digest │
165 ├──────────────┼───────────────────────────────┤
166 │.History │ History of the image layer │
167 ├──────────────┼───────────────────────────────┤
168 │.ID │ Image ID (truncated) │
169 ├──────────────┼───────────────────────────────┤
170 │.Id │ Image ID (full SHA) │
171 ├──────────────┼───────────────────────────────┤
172 │.IsDangling │ Is image dangling? │
173 │ │ (true/false) │
174 ├──────────────┼───────────────────────────────┤
175 │.IsReadOnly │ Is unage read-only? │
176 │ │ (true/false) │
177 ├──────────────┼───────────────────────────────┤
178 │.Labels │ map[] of labels │
179 ├──────────────┼───────────────────────────────┤
180 │.Names │ Image FQIN │
181 ├──────────────┼───────────────────────────────┤
182 │.ParentId │ Full SHA of parent image ID, │
183 │ │ or null (string) │
184 ├──────────────┼───────────────────────────────┤
185 │.ReadOnly │ Same as .IsReadOnly │
186 ├──────────────┼───────────────────────────────┤
187 │.RepoDigests │ map[] of zero or more │
188 │ │ repo/name@sha256:SHA strings │
189 ├──────────────┼───────────────────────────────┤
190 │.Repository │ Image repository │
191 ├──────────────┼───────────────────────────────┤
192 │.RepoTags │ map[] of zero or more FQIN │
193 │ │ strings for this image │
194 ├──────────────┼───────────────────────────────┤
195 │.SharedSize │ Always seems to be 0 │
196 ├──────────────┼───────────────────────────────┤
197 │.Size │ Size of layer on disk (human- │
198 │ │ friendly string) │
199 ├──────────────┼───────────────────────────────┤
200 │.Tag │ Image tag │
201 ├──────────────┼───────────────────────────────┤
202 │.VirtualSize │ Size of layer on disk (bytes) │
203 └──────────────┴───────────────────────────────┘
204 --history
206 Display the history of image names. If an image gets re-tagged or un‐
207 tagged, then the image name history gets prepended (latest image
208 first). This is especially useful when undoing a tag operation or an
209 image does not contain any name because it has been untagged.
210 --no-trunc
213 Do not truncate the output (default false).
214 --noheading, -n
217 Omit the table headings from the listing.
218 --quiet, -q
221 Lists only the image IDs.
222 --sort=sort
225 Sort by created, id, repository, size or tag (default: created)
226
229 $ podman images
230 REPOSITORY TAG IMAGE ID CREATED SIZE
231 quay.io/podman/stable latest e0b7dabc3352 22 hours ago 331 MB
232 docker.io/library/alpine latest 9c6f07244728 5 days ago 5.83 MB
233 registry.fedoraproject.org/fedora latest 2ecb6df95994 3 weeks ago 169 MB
234 quay.io/libpod/testimage 20220615 f26aa69bb3f3 2 months ago 8.4 MB
235 $ podman images stable
238 REPOSITORY TAG IMAGE ID CREATED SIZE
239 quay.io/podman/stable latest e0b7dabc3352 22 hours ago 331 MB
240 # podman image ls --quiet
243 e3d42bcaf643
244 ebb91b73692b
245 4526339ae51c
246 # podman images --noheading
249 docker.io/kubernetes/pause latest e3d42bcaf643 3 years ago 251 kB
250 <none> <none> ebb91b73692b 4 weeks ago 27.2 MB
251 docker.io/library/ubuntu latest 4526339ae51c 6 weeks ago 126 MB
252 # podman image list --no-trunc
255 REPOSITORY TAG IMAGE ID CREATED SIZE
256 docker.io/kubernetes/pause latest sha256:e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27 3 years ago 251 kB
257 <none> <none> sha256:ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9 4 weeks ago 27.2 MB
258 docker.io/library/ubuntu latest sha256:4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a 6 weeks ago 126 MB
259 # podman images --format "table {{.ID}} {{.Repository}} {{.Tag}}"
262 IMAGE ID REPOSITORY TAG
263 e3d42bcaf643 docker.io/kubernetes/pause latest
264 ebb91b73692b <none> <none>
265 4526339ae51c docker.io/library/ubuntu latest
266 # podman images --filter dangling=true
269 REPOSITORY TAG IMAGE ID CREATED SIZE
270 <none> <none> ebb91b73692b 4 weeks ago 27.2 MB
271 # podman images --format json
274 [
275 {
276 "id": "e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27",
277 "names": [
278 "docker.io/kubernetes/pause:latest"
279 ],
280 "digest": "sha256:0aecf73ff86844324847883f2e916d3f6984c5fae3c2f23e91d66f549fe7d423",
281 "created": "2014-07-19T07:02:32.267701596Z",
282 "size": 250665
283 },
284 {
285 "id": "ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9",
286 "names": [
287 "\u003cnone\u003e"
288 ],
289 "digest": "sha256:ba7e4091d27e8114a205003ca6a768905c3395d961624a2c78873d9526461032",
290 "created": "2017-10-26T03:07:22.796184288Z",
291 "size": 27170520
292 },
293 {
294 "id": "4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a",
295 "names": [
296 "docker.io/library/ubuntu:latest"
297 ],
298 "digest": "sha256:193f7734ddd68e0fb24ba9af8c2b673aecb0227b026871f8e932dab45add7753",
299 "created": "2017-10-10T20:59:05.10196344Z",
300 "size": 126085200
301 }
302 ]
303 # podman images --sort repository
306 REPOSITORY TAG IMAGE ID CREATED SIZE
307 <none> <none> 2460217d76fc About a minute ago 4.41 MB
308 docker.io/library/alpine latest 3fd9065eaf02 5 months ago 4.41 MB
309 localhost/myapp latest b2e0ad03474a About a minute ago 4.41 MB
310 registry.access.redhat.com/rhel7 latest 7a840db7f020 2 weeks ago 211 MB
311 registry.fedoraproject.org/fedora 27 801894bc0e43 6 weeks ago 246 MB
312 # podman images
315 REPOSITORY TAG IMAGE ID CREATED SIZE
316 localhost/test latest 18f0c080cd72 4 seconds ago 4.42 MB
317 docker.io/library/alpine latest 3fd9065eaf02 5 months ago 4.41 MB
318 # podman images -a
319 REPOSITORY TAG IMAGE ID CREATED SIZE
320 localhost/test latest 18f0c080cd72 6 seconds ago 4.42 MB
321 <none> <none> 270e70dc54c0 7 seconds ago 4.42 MB
322 <none> <none> 4ed6fbe43414 8 seconds ago 4.41 MB
323 <none> <none> 6b0df8e71508 8 seconds ago 4.41 MB
324 docker.io/library/alpine latest 3fd9065eaf02 5 months ago 4.41 MB
325
329 podman(1), containers-storage.conf(5)
330
333 March 2017, Originally compiled by Dan Walsh <dwalsh@redhat.com>
334 podman-images(1)