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

NAME

6       buildah-images - List images in local storage.
7
8

SYNOPSIS

10       buildah images [options] [image]
11
12

DESCRIPTION

14       Displays  locally  stored  images, their names, sizes, created date and
15       their IDs.  The created date is displayed in the time locale of the lo‐
16       cal machine.
17
18

OPTIONS

20       --all, -a
21
22
23       Show all images, including intermediate images from a build.
24
25
26       --digests
27
28
29       Show the image digests.
30
31
32       --filter, -f=[]
33
34
35       Filter output based on conditions provided (default []).
36
37
38       Filters:
39
40
41       after,since=image
42           Filter on images created since the given image.
43
44
45       before=image
46           Filter on images created before the given image.
47
48
49       dangling=true|false
50           Show  dangling images. An images is considered to be dangling if it
51       has no associated names and tags.
52
53
54       id=id
55           Show image with this specific ID.
56
57
58       intermediate=true|false
59           Show intermediate images. An images is considered to be an inderme‐
60       diate image if it is dangling and has no children.
61
62
63       label=key[=value]
64           Filter by images labels key and/or value.
65
66
67       readonly=true|false
68           Show  only read only images or Read/Write images. The default is to
69       show both.  Read/Only images can be configured by modifying the  "addi‐
70       tionalimagestores" in the /etc/containers/storage.conf file.
71
72
73       reference=reference
74           Show  images  matching  the specified reference. Wildcards are sup‐
75       ported (e.g., "reference=fedora:3").
76
77
78       --format="TEMPLATE"
79
80
81       Pretty-print images using a Go template.
82
83
84       Valid placeholders for the Go template are listed below:
85
86
87       ┌──────────────┬────────────────────────────────┐
88Placeholder   Description                    
89       ├──────────────┼────────────────────────────────┤
90       │.Created      │ Creation date in epoch time    │
91       ├──────────────┼────────────────────────────────┤
92       │.CreatedAt    │ Creation date Pretty Formatted │
93       ├──────────────┼────────────────────────────────┤
94       │.CreatedAtRaw │ Creation date in raw format    │
95       ├──────────────┼────────────────────────────────┤
96       │.Digest       │ Image Digest                   │
97       ├──────────────┼────────────────────────────────┤
98       │.ID           │ Image ID                       │
99       ├──────────────┼────────────────────────────────┤
100       │.Name         │ Image Name                     │
101       ├──────────────┼────────────────────────────────┤
102       │.ReadOnly     │ Indicates if image came from a │
103       │              │ R/O store                      │
104       ├──────────────┼────────────────────────────────┤
105       │.Size         │ Image Size                     │
106       ├──────────────┼────────────────────────────────┤
107       │.Tag          │ Image Tag                      │
108       └──────────────┴────────────────────────────────┘
109
110       --history
111
112
113       Display the image name history.
114
115
116       --json
117
118
119       Display the output in JSON format.
120
121
122       --no-trunc
123
124
125       Do not truncate output.
126
127
128       --noheading, -n
129
130
131       Omit the table headings from the listing of images.
132
133
134       --quiet, -q
135
136
137       Displays only the image IDs.
138
139

EXAMPLE

141       buildah images
142
143
144       buildah images fedora:latest
145
146
147       buildah images --json
148
149
150       buildah images --quiet
151
152
153       buildah images -q --noheading --no-trunc
154
155
156       buildah images --quiet fedora:latest
157
158
159       buildah images --filter dangling=true
160
161
162       buildah images --format "ImageID: {{.ID}}"
163
164
165              $ buildah images
166              REPOSITORY                        TAG        IMAGE ID       CREATED        SIZE
167              registry.access.redhat.com/ubi8   latest     53ce4390f2ad   3 weeks ago    233 MB
168              docker.io/library/busybox         latest     16ea53ea7c65   3 weeks ago    1.46 MB
169              quay.io/libpod/testimage          20210610   9f9ec7f2fdef   4 months ago   7.99 MB
170
171
172
173              # buildah images -a
174              IMAGE NAME                                               IMAGE TAG            IMAGE ID             CREATED AT             SIZE
175              registry.access.redhat.com/ubi8   latest     53ce4390f2ad   3 weeks ago    233 MB
176              <none>                                                   <none>               8c6e16890c2b         Jun 13, 2018 15:52     4.42 MB
177              localhost/test                                           latest               c0cfe75da054         Jun 13, 2018 15:52     4.42 MB
178
179
180
181              # buildah images --format '{{.ID}} {{.CreatedAtRaw}}'
182              3f53bb00af943dfdf815650be70c0fa7b426e56a66f5e3362b47a129d57d5991 2018-12-20 19:21:30.122610396 -0500 EST
183              8e09da8f6701d7cde1526d79e3123b0f1109b78d925dfe9f9bac6d59d702a390 2019-01-08 09:22:52.330623532 -0500 EST
184
185
186
187              # buildah images --format '{{.ID}} {{.Name}} {{.Digest}} {{.CreatedAt}} {{.Size}} {{.CreatedAtRaw}}'
188              3f53bb00af943dfdf815650be70c0fa7b426e56a66f5e3362b47a129d57d5991 docker.io/library/alpine sha256:3d2e482b82608d153a374df3357c0291589a61cc194ec4a9ca2381073a17f58e Dec 20, 2018 19:21 4.67 MB 2018-12-20 19:21:30.122610396 -0500 EST
189              8e09da8f6701d7cde1526d79e3123b0f1109b78d925dfe9f9bac6d59d702a390 <none> sha256:894532ec56e0205ce68ca7230b00c18aa3c8ee39fcdb310615c60e813057229c Jan 8, 2019 09:22 4.67 MB 2019-01-08 09:22:52.330623532 -0500 EST
190
191
192

SEE ALSO

194       buildah(1), containers-storage.conf(5)
195
196
197
198buildah                           March 2017                 buildah-images(1)
Impressum