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 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 │intermediate │ Filter by images that are │
61 │ │ dangling and have no chil‐ │
62 │ │ dren │
63 ├─────────────┼────────────────────────────┤
64 │label │ Filter by images with (or │
65 │ │ without, in the case of │
66 │ │ label!=[...] is used) the │
67 │ │ specified labels. │
68 ├─────────────┼────────────────────────────┤
69 │manifest │ Filter by images that are │
70 │ │ manifest lists. │
71 ├─────────────┼────────────────────────────┤
72 │readonly │ Filter by read-only or │
73 │ │ read/write images. │
74 ├─────────────┼────────────────────────────┤
75 │reference │ Filter by image name. │
76 ├─────────────┼────────────────────────────┤
77 │after/since │ Filter by images created │
78 │ │ after the given IMAGE │
79 │ │ (name or tag). │
80 ├─────────────┼────────────────────────────┤
81 │until │ Filter by images created │
82 │ │ until the given duration │
83 │ │ or time. │
84 └─────────────┴────────────────────────────┘
85 The id filter accepts the image id string.
87 The before filter accepts formats: <image-name>[:<tag>], <image id> or
90 <image@digest>.
91 The containers filter shows images that have a running container based
94 on that image.
95 The dangling filter shows images that are taking up disk space and
98 serve no purpose. Dangling image is a file system layer that was used
99 in a previous build of an image and is no longer referenced by any im‐
100 age. They are denoted with the <none> tag, consume disk space and serve
101 no active purpose.
102 The intermediate filter shows images that are dangling and have no
105 children.
106 The label filter accepts two formats. One is the label=key or la‐
109 bel=key=value, which shows images with the specified labels. The other
110 format is the label!=key or label!=key=value, which shows images with‐
111 out the specified labels.
112 The manifest filter shows images that are manifest lists.
115 The readonly filter shows, as a default, both read-only and read/write
118 images. Read-only images can be configured by modifying the addition‐
119 alimagestores in the /etc/containers/storage.conf file.
120 The reference filter accepts the pattern of an image reference <image-
123 name>[:<tag>].
124 The after or since filter accepts formats: <image-name>[:<tag>], <image
127 id> or <image@digest>.
128 The until filter accepts formats: golang duration, RFC3339 time, or a
131 Unix timestamp and shows all images that are created until that time.
132 --format=format
135 Change the default output format. This can be of a supported type like
136 'json' or a Go template. Valid placeholders for the Go template are
137 listed below:
138 ┌──────────────┬────────────────────────────┐
141 │Placeholder │ Description │
142 ├──────────────┼────────────────────────────┤
143 │.ID │ Image ID │
144 ├──────────────┼────────────────────────────┤
145 │.Repository │ Image repository │
146 ├──────────────┼────────────────────────────┤
147 │.Tag │ Image tag │
148 ├──────────────┼────────────────────────────┤
149 │.Digest │ Image digest │
150 ├──────────────┼────────────────────────────┤
151 │.CreatedSince │ Elapsed time since the im‐ │
152 │ │ age was created │
153 ├──────────────┼────────────────────────────┤
154 │.CreatedAt │ Time when the image was │
155 │ │ created │
156 ├──────────────┼────────────────────────────┤
157 │.Size │ Size of layer on disk │
158 ├──────────────┼────────────────────────────┤
159 │.History │ History of the image layer │
160 └──────────────┴────────────────────────────┘
161 --history
163 Display the history of image names. If an image gets re-tagged or un‐
164 tagged, then the image name history gets prepended (latest image
165 first). This is especially useful when undoing a tag operation or an
166 image does not contain any name because it has been untagged.
167 --no-trunc
170 Do not truncate the output (default false).
171 --noheading, -n
174 Omit the table headings from the listing of images.
175 --quiet, -q
178 Lists only the image IDs.
179 --sort=sort=created
182 Sort by created, id, repository, size or tag (default: created)
183
186 # podman images
187 REPOSITORY TAG IMAGE ID CREATED SIZE
188 docker.io/kubernetes/pause latest e3d42bcaf643 3 years ago 251 kB
189 <none> <none> ebb91b73692b 4 weeks ago 27.2 MB
190 docker.io/library/ubuntu latest 4526339ae51c 6 weeks ago 126 MB
191 # podman images --quiet
195 e3d42bcaf643
196 ebb91b73692b
197 4526339ae51c
198 # podman images --noheading
202 docker.io/kubernetes/pause latest e3d42bcaf643 3 years ago 251 kB
203 <none> <none> ebb91b73692b 4 weeks ago 27.2 MB
204 docker.io/library/ubuntu latest 4526339ae51c 6 weeks ago 126 MB
205 # podman images --no-trunc
209 REPOSITORY TAG IMAGE ID CREATED SIZE
210 docker.io/kubernetes/pause latest sha256:e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27 3 years ago 251 kB
211 <none> <none> sha256:ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9 4 weeks ago 27.2 MB
212 docker.io/library/ubuntu latest sha256:4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a 6 weeks ago 126 MB
213 # podman images --format "table {{.ID}} {{.Repository}} {{.Tag}}"
217 IMAGE ID REPOSITORY TAG
218 e3d42bcaf643 docker.io/kubernetes/pause latest
219 ebb91b73692b <none> <none>
220 4526339ae51c docker.io/library/ubuntu latest
221 # podman images --filter dangling=true
225 REPOSITORY TAG IMAGE ID CREATED SIZE
226 <none> <none> ebb91b73692b 4 weeks ago 27.2 MB
227 # podman images --format json
231 [
232 {
233 "id": "e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27",
234 "names": [
235 "docker.io/kubernetes/pause:latest"
236 ],
237 "digest": "sha256:0aecf73ff86844324847883f2e916d3f6984c5fae3c2f23e91d66f549fe7d423",
238 "created": "2014-07-19T07:02:32.267701596Z",
239 "size": 250665
240 },
241 {
242 "id": "ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9",
243 "names": [
244 "\u003cnone\u003e"
245 ],
246 "digest": "sha256:ba7e4091d27e8114a205003ca6a768905c3395d961624a2c78873d9526461032",
247 "created": "2017-10-26T03:07:22.796184288Z",
248 "size": 27170520
249 },
250 {
251 "id": "4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a",
252 "names": [
253 "docker.io/library/ubuntu:latest"
254 ],
255 "digest": "sha256:193f7734ddd68e0fb24ba9af8c2b673aecb0227b026871f8e932dab45add7753",
256 "created": "2017-10-10T20:59:05.10196344Z",
257 "size": 126085200
258 }
259 ]
260 # podman images --sort repository
264 REPOSITORY TAG IMAGE ID CREATED SIZE
265 <none> <none> 2460217d76fc About a minute ago 4.41 MB
266 docker.io/library/alpine latest 3fd9065eaf02 5 months ago 4.41 MB
267 localhost/myapp latest b2e0ad03474a About a minute ago 4.41 MB
268 registry.access.redhat.com/rhel7 latest 7a840db7f020 2 weeks ago 211 MB
269 registry.fedoraproject.org/fedora 27 801894bc0e43 6 weeks ago 246 MB
270 # podman images
274 REPOSITORY TAG IMAGE ID CREATED SIZE
275 localhost/test latest 18f0c080cd72 4 seconds ago 4.42 MB
276 docker.io/library/alpine latest 3fd9065eaf02 5 months ago 4.41 MB
277 # podman images -a
278 REPOSITORY TAG IMAGE ID CREATED SIZE
279 localhost/test latest 18f0c080cd72 6 seconds ago 4.42 MB
280 <none> <none> 270e70dc54c0 7 seconds ago 4.42 MB
281 <none> <none> 4ed6fbe43414 8 seconds ago 4.41 MB
282 <none> <none> 6b0df8e71508 8 seconds ago 4.41 MB
283 docker.io/library/alpine latest 3fd9065eaf02 5 months ago 4.41 MB
284
288 podman(1), containers-storage.conf(5)
289
292 March 2017, Originally compiled by Dan Walsh <dwalsh@redhat.com>
293 podman-images(1)()