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       -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       after==TIMESTRING
47           Filter on images created after the given time.Time.
48
49
50       before==TIMESTRING
51           Filter on images created before the given time.Time.
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.
80
81
82       --noheading, -n
83
84
85       Omit the table headings from the listing of images.
86
87
88       --no-trunc, --notruncate
89
90
91       Do not truncate output.
92
93
94       --quiet, -q
95
96
97       Lists only the image IDs.
98
99
100       --sort=sort
101
102
103       Sort by created, id, repository, size or tag (default: created)
104
105

EXAMPLE

107              # podman images
108              REPOSITORY                                   TAG      IMAGE ID       CREATED       SIZE
109              docker.io/kubernetes/pause                   latest   e3d42bcaf643   3 years ago   251 kB
110              <none>                                       <none>   ebb91b73692b   4 weeks ago   27.2 MB
111              docker.io/library/ubuntu                     latest   4526339ae51c   6 weeks ago   126 MB
112
113
114
115              # podman images --quiet
116              e3d42bcaf643
117              ebb91b73692b
118              4526339ae51c
119
120
121
122              # podman images --noheading
123              docker.io/kubernetes/pause                   latest   e3d42bcaf643   3 years ago   251 kB
124              <none>                                       <none>   ebb91b73692b   4 weeks ago   27.2 MB
125              docker.io/library/ubuntu                     latest   4526339ae51c   6 weeks ago   126 MB
126
127
128
129              # podman images --no-trunc
130              REPOSITORY                                   TAG      IMAGE ID                                                                  CREATED       SIZE
131              docker.io/kubernetes/pause                   latest   sha256:e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27   3 years ago   251 kB
132              <none>                                       <none>   sha256:ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9   4 weeks ago   27.2 MB
133              docker.io/library/ubuntu                     latest   sha256:4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a   6 weeks ago   126 MB
134
135
136
137              # podman images --format "table {{.ID}} {{.Repository}} {{.Tag}}"
138              IMAGE ID       REPOSITORY                                   TAG
139              e3d42bcaf643   docker.io/kubernetes/pause                   latest
140              ebb91b73692b   <none>                                       <none>
141              4526339ae51c   docker.io/library/ubuntu                     latest
142
143
144
145              # podman images --filter dangling=true
146              REPOSITORY   TAG      IMAGE ID       CREATED       SIZE
147              <none>       <none>   ebb91b73692b   4 weeks ago   27.2 MB
148
149
150
151              # podman images --format json
152              [
153                  {
154                   "id": "e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27",
155                   "names": [
156                       "docker.io/kubernetes/pause:latest"
157                   ],
158                   "digest": "sha256:0aecf73ff86844324847883f2e916d3f6984c5fae3c2f23e91d66f549fe7d423",
159                   "created": "2014-07-19T07:02:32.267701596Z",
160                   "size": 250665
161                  },
162                  {
163                   "id": "ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9",
164                   "names": [
165                       "\u003cnone\u003e"
166                   ],
167                   "digest": "sha256:ba7e4091d27e8114a205003ca6a768905c3395d961624a2c78873d9526461032",
168                   "created": "2017-10-26T03:07:22.796184288Z",
169                   "size": 27170520
170                  },
171                  {
172                   "id": "4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a",
173                   "names": [
174                       "docker.io/library/ubuntu:latest"
175                   ],
176                   "digest": "sha256:193f7734ddd68e0fb24ba9af8c2b673aecb0227b026871f8e932dab45add7753",
177                   "created": "2017-10-10T20:59:05.10196344Z",
178                   "size": 126085200
179                  }
180              ]
181
182
183
184              # podman images --sort repository
185              REPOSITORY                                   TAG      IMAGE ID       CREATED       SIZE
186              <none>                                      <none>   2460217d76fc   About a minute ago   4.41 MB
187              docker.io/library/alpine                    latest   3fd9065eaf02   5 months ago         4.41 MB
188              localhost/myapp                             latest   b2e0ad03474a   About a minute ago   4.41 MB
189              registry.access.redhat.com/rhel7            latest   7a840db7f020   2 weeks ago          211 MB
190              registry.fedoraproject.org/fedora           27       801894bc0e43   6 weeks ago          246 MB
191
192
193
194              # podman images
195              REPOSITORY                 TAG      IMAGE ID       CREATED         SIZE
196              localhost/test             latest   18f0c080cd72   4 seconds ago   4.42 MB
197              docker.io/library/alpine   latest   3fd9065eaf02   5 months ago    4.41 MB
198              # podman images -a
199              REPOSITORY                 TAG      IMAGE ID       CREATED         SIZE
200              localhost/test             latest   18f0c080cd72   6 seconds ago   4.42 MB
201              <none>                     <none>   270e70dc54c0   7 seconds ago   4.42 MB
202              <none>                     <none>   4ed6fbe43414   8 seconds ago   4.41 MB
203              <none>                     <none>   6b0df8e71508   8 seconds ago   4.41 MB
204              docker.io/library/alpine   latest   3fd9065eaf02   5 months ago    4.41 MB
205
206
207

SEE ALSO

209       podman(1), containers-storage.conf(5)
210
211

HISTORY

213       March  2017,  Originally  compiled  by  Dan   Walsh   dwalsh@redhat.com
214       ⟨mailto:dwalsh@redhat.com⟩
215
216
217
218                                                            podman-images(1)()
Impressum