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       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       ┌──────────────┬────────────────────────────┐
84Placeholder   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

EXAMPLE

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

SEE ALSO

243       podman(1), containers-storage.conf(5)
244
245

HISTORY

247       March  2017,  Originally  compiled  by  Dan   Walsh   dwalsh@redhat.com
248       ⟨mailto:dwalsh@redhat.com⟩
249
250
251
252                                                            podman-images(1)()
Impressum