1podman-images(1)            General Commands Manual           podman-images(1)
2
3
4

NAME

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

SYNOPSIS

10       podman images [options] [image]
11
12
13       podman image list [options] [image]
14
15
16       podman image ls [options] [image]
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, -f=filter
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
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              quay.io/podman/stable              latest      e0b7dabc3352  22 hours ago  331 MB
189              docker.io/library/alpine           latest      9c6f07244728  5 days ago    5.83 MB
190              registry.fedoraproject.org/fedora  latest      2ecb6df95994  3 weeks ago   169 MB
191              quay.io/libpod/testimage           20220615    f26aa69bb3f3  2 months ago  8.4 MB
192
193
194
195              $ podman images stable
196              REPOSITORY             TAG         IMAGE ID      CREATED       SIZE
197              quay.io/podman/stable  latest      e0b7dabc3352  22 hours ago  331 MB
198
199
200
201              # podman image ls --quiet
202              e3d42bcaf643
203              ebb91b73692b
204              4526339ae51c
205
206
207
208              # podman images --noheading
209              docker.io/kubernetes/pause                   latest   e3d42bcaf643   3 years ago   251 kB
210              <none>                                       <none>   ebb91b73692b   4 weeks ago   27.2 MB
211              docker.io/library/ubuntu                     latest   4526339ae51c   6 weeks ago   126 MB
212
213
214
215              # podman image list --no-trunc
216              REPOSITORY                                   TAG      IMAGE ID                                                                  CREATED       SIZE
217              docker.io/kubernetes/pause                   latest   sha256:e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27   3 years ago   251 kB
218              <none>                                       <none>   sha256:ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9   4 weeks ago   27.2 MB
219              docker.io/library/ubuntu                     latest   sha256:4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a   6 weeks ago   126 MB
220
221
222
223              # podman images --format "table {{.ID}} {{.Repository}} {{.Tag}}"
224              IMAGE ID       REPOSITORY                                   TAG
225              e3d42bcaf643   docker.io/kubernetes/pause                   latest
226              ebb91b73692b   <none>                                       <none>
227              4526339ae51c   docker.io/library/ubuntu                     latest
228
229
230
231              # podman images --filter dangling=true
232              REPOSITORY   TAG      IMAGE ID       CREATED       SIZE
233              <none>       <none>   ebb91b73692b   4 weeks ago   27.2 MB
234
235
236
237              # podman images --format json
238              [
239                  {
240                            "id": "e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27",
241                            "names": [
242                                "docker.io/kubernetes/pause:latest"
243                            ],
244                            "digest": "sha256:0aecf73ff86844324847883f2e916d3f6984c5fae3c2f23e91d66f549fe7d423",
245                            "created": "2014-07-19T07:02:32.267701596Z",
246                            "size": 250665
247                  },
248                  {
249                            "id": "ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9",
250                            "names": [
251                                "\u003cnone\u003e"
252                            ],
253                            "digest": "sha256:ba7e4091d27e8114a205003ca6a768905c3395d961624a2c78873d9526461032",
254                            "created": "2017-10-26T03:07:22.796184288Z",
255                            "size": 27170520
256                  },
257                  {
258                            "id": "4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a",
259                            "names": [
260                                "docker.io/library/ubuntu:latest"
261                            ],
262                            "digest": "sha256:193f7734ddd68e0fb24ba9af8c2b673aecb0227b026871f8e932dab45add7753",
263                            "created": "2017-10-10T20:59:05.10196344Z",
264                            "size": 126085200
265                  }
266              ]
267
268
269
270              # podman images --sort repository
271              REPOSITORY                                   TAG      IMAGE ID       CREATED       SIZE
272              <none>                                      <none>   2460217d76fc   About a minute ago   4.41 MB
273              docker.io/library/alpine                    latest   3fd9065eaf02   5 months ago         4.41 MB
274              localhost/myapp                             latest   b2e0ad03474a   About a minute ago   4.41 MB
275              registry.access.redhat.com/rhel7            latest   7a840db7f020   2 weeks ago          211 MB
276              registry.fedoraproject.org/fedora           27       801894bc0e43   6 weeks ago          246 MB
277
278
279
280              # podman images
281              REPOSITORY                 TAG      IMAGE ID       CREATED         SIZE
282              localhost/test             latest   18f0c080cd72   4 seconds ago   4.42 MB
283              docker.io/library/alpine   latest   3fd9065eaf02   5 months ago    4.41 MB
284              # podman images -a
285              REPOSITORY                 TAG      IMAGE ID       CREATED         SIZE
286              localhost/test             latest   18f0c080cd72   6 seconds ago   4.42 MB
287              <none>                     <none>   270e70dc54c0   7 seconds ago   4.42 MB
288              <none>                     <none>   4ed6fbe43414   8 seconds ago   4.41 MB
289              <none>                     <none>   6b0df8e71508   8 seconds ago   4.41 MB
290              docker.io/library/alpine   latest   3fd9065eaf02   5 months ago    4.41 MB
291
292
293

SEE ALSO

295       podman(1), containers-storage.conf(5)
296
297

HISTORY

299       March 2017, Originally compiled by Dan Walsh <dwalsh@redhat.com>
300
301
302
303                                                              podman-images(1)
Impressum