1podman-images(1)()                                          podman-images(1)()
2
3
4

NAME

6       podman-images - List images in local storage
7
8

SYNOPSIS

10       podman images [options]
11
12
13       podman image list [options]
14
15
16       podman image ls [options]
17
18

DESCRIPTION

20       Displays locally stored images, their names, and their IDs.
21
22

OPTIONS

24   --all, -a
25       Show  all images (by default filter out the intermediate image layers).
26       The default is false.
27
28
29   --digests
30       Show image digests
31
32
33   --filter=filter, -f
34       Provide filter values.
35
36
37       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
41
42       Supported filters:
43
44
45       ┌─────────────┬────────────────────────────┐
46Filter       Description                
47       ├─────────────┼────────────────────────────┤
48id           │ Filter by image id.        │
49       ├─────────────┼────────────────────────────┤
50before       │ Filter by  images  created │
51       │             │ before   the  given  IMAGE │
52       │             │ (name or tag).             │
53       ├─────────────┼────────────────────────────┤
54containers   │ Filter by  images  with  a │
55       │             │ running container.         │
56       ├─────────────┼────────────────────────────┤
57dangling     │ Filter  by  dangling  (un‐ │
58       │             │ used) images.              │
59       ├─────────────┼────────────────────────────┤
60intermediate │ Filter by images that  are │
61       │             │ dangling and have no chil‐ │
62       │             │ dren                       │
63       ├─────────────┼────────────────────────────┤
64label        │ Filter by images with  (or │
65       │             │ without,  in  the  case of │
66       │             │ label!=[...] is used)  the │
67       │             │ specified labels.          │
68       ├─────────────┼────────────────────────────┤
69manifest     │ Filter  by images that are │
70       │             │ manifest lists.            │
71       ├─────────────┼────────────────────────────┤
72readonly     │ Filter  by  read-only   or │
73       │             │ read/write images.         │
74       ├─────────────┼────────────────────────────┤
75reference    │ Filter by image name.      │
76       ├─────────────┼────────────────────────────┤
77after/since  │ Filter  by  images created │
78       │             │ after  the   given   IMAGE │
79       │             │ (name or tag).             │
80       ├─────────────┼────────────────────────────┤
81until        │ Filter  by  images created │
82       │             │ until the  given  duration │
83       │             │ or time.                   │
84       └─────────────┴────────────────────────────┘
85
86       The id filter accepts the image id string.
87
88
89       The  before filter accepts formats: <image-name>[:<tag>], <image id> or
90       <image@digest>.
91
92
93       The containers filter shows images that have a running container  based
94       on that image.
95
96
97       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
103
104       The  intermediate  filter  shows  images  that are dangling and have no
105       children.
106
107
108       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
113
114       The manifest filter shows images that are manifest lists.
115
116
117       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
121
122       The  reference filter accepts the pattern of an image reference <image-
123       name>[:<tag>].
124
125
126       The after or since filter accepts formats: <image-name>[:<tag>], <image
127       id> or <image@digest>.
128
129
130       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
133
134   --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
139
140       ┌──────────────┬────────────────────────────┐
141Placeholder   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
162   --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
168
169   --no-trunc
170       Do not truncate the output (default false).
171
172
173   --noheading, -n
174       Omit the table headings from the listing of images.
175
176
177   --quiet, -q
178       Lists only the image IDs.
179
180
181   --sort=sort=created
182       Sort by created, id, repository, size or tag (default: created)
183
184

EXAMPLE

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
192
193
194              # podman images --quiet
195              e3d42bcaf643
196              ebb91b73692b
197              4526339ae51c
198
199
200
201              # 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
206
207
208              # 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
214
215
216              # 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
222
223
224              # podman images --filter dangling=true
225              REPOSITORY   TAG      IMAGE ID       CREATED       SIZE
226              <none>       <none>   ebb91b73692b   4 weeks ago   27.2 MB
227
228
229
230              # 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
261
262
263              # 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
271
272
273              # 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
285
286

SEE ALSO

288       podman(1), containers-storage.conf(5)
289
290

HISTORY

292       March 2017, Originally compiled by Dan Walsh <dwalsh@redhat.com>
293
294
295
296                                                            podman-images(1)()
Impressum