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