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 active images. They are denoted with the <none> tag,  consume  disk
52       space and 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       └──────────────┴────────────────────────────┘
100
101   --history
102       Display  the history of image names.  If an image gets re-tagged or un‐
103       tagged, then the  image  name  history  gets  prepended  (latest  image
104       first).   This  is especially useful when undoing a tag operation or an
105       image does not contain any name because it has been untagged.
106
107
108   --noheading, -n
109       Omit the table headings from the listing of images.
110
111
112   --no-trunc
113       Do not truncate output.
114
115
116   --quiet, -q
117       Lists only the image IDs.
118
119
120   --sort=sort
121       Sort by created, id, repository, size or tag (default: created)
122
123

EXAMPLE

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

SEE ALSO

227       podman(1), containers-storage.conf(5)
228
229

HISTORY

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