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 <none> tag, consume disk
52 space 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 im‐ │
87 │ │ age 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 un‐
103 tagged, 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 podman-images(1)()