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       Filter output based on conditions provided
35
36
37       Filters:
38
39
40       since=IMAGE
41           Filter on images created after the given IMAGE (name or tag).
42
43
44       before=IMAGE
45           Filter on images created before the given IMAGE (name or tag).
46
47
48       dangling=true|false
49           Show dangling images. Dangling images are a file system layer  that
50       was used in a previous build of an image and is no longer referenced by
51       any image. They are denoted with the <none> tag, consume disk space and
52       serve no active purpose.
53
54
55       label
56           Filter by images labels key and/or value.
57
58
59       readonly=true|false
60            Show only read only images or Read/Write images. The default is to
61       show both.  Read/Only images can be configured by modifying the  "addi‐
62       tionalimagestores" in the /etc/containers/storage.conf file.
63
64
65       reference=
66            Filter by image name, specified as regular expressions.
67
68
69   --format=format
70       Change the default output format.  This can be of a supported type like
71       'json' or a Go template.  Valid placeholders for the  Go  template  are
72       listed below:
73
74
75       ┌──────────────┬────────────────────────────┐
76Placeholder   Description                
77       ├──────────────┼────────────────────────────┤
78       │.ID           │ Image ID                   │
79       ├──────────────┼────────────────────────────┤
80       │.Repository   │ Image repository           │
81       ├──────────────┼────────────────────────────┤
82       │.Tag          │ Image tag                  │
83       ├──────────────┼────────────────────────────┤
84       │.Digest       │ Image digest               │
85       ├──────────────┼────────────────────────────┤
86       │.CreatedSince │ Elapsed time since the im‐ │
87       │              │ age        was        cre‐ │
88       │              │ ated                       │
89       │              │                            │
90       ├──────────────┼────────────────────────────┤
91       │.CreatedAt    │ Time when  the  image  was │
92       │              │ created                    │
93       ├──────────────┼────────────────────────────┤
94       │.Size         │ Size of layer on disk      │
95       ├──────────────┼────────────────────────────┤
96       │.History      │ History of the image layer │
97       └──────────────┴────────────────────────────┘
98
99   --history
100       Display  the history of image names.  If an image gets re-tagged or un‐
101       tagged, then the  image  name  history  gets  prepended  (latest  image
102       first).   This  is especially useful when undoing a tag operation or an
103       image does not contain any name because it has been untagged.
104
105
106   --noheading, -n
107       Omit the table headings from the listing of images.
108
109
110   --no-trunc
111       Do not truncate output.
112
113
114   --quiet, -q
115       Lists only the image IDs.
116
117
118   --sort=sort
119       Sort by created, id, repository, size or tag (default: created)
120
121

EXAMPLE

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

SEE ALSO

225       podman(1), containers-storage.conf(5)
226
227

HISTORY

229       March 2017, Originally compiled by Dan Walsh <dwalsh@redhat.com>
230
231
232
233                                                            podman-images(1)()
Impressum