1buildah-images(1) General Commands Manual buildah-images(1)
2
3
4
6 buildah-images - List images in local storage.
7
8
10 buildah images [options] [image]
11
12
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
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 ┌──────────────┬────────────────────────────────┐
88 │Placeholder │ 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 --noheading, -n
123
124
125 Omit the table headings from the listing of images.
126
127
128 --no-trunc
129
130
131 Do not truncate output.
132
133
134 --quiet, -q
135
136
137 Displays only the image IDs.
138
139
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 IMAGE NAME IMAGE TAG IMAGE ID CREATED AT SIZE
167 docker.io/library/alpine latest 3fd9065eaf02 Jan 9, 2018 16:10 4.41 MB
168 localhost/test latest c0cfe75da054 Jun 13, 2018 15:52 4.42 MB
169
170
171
172 # buildah images -a
173 IMAGE NAME IMAGE TAG IMAGE ID CREATED AT SIZE
174 docker.io/library/alpine latest 3fd9065eaf02 Jan 9, 2018 16:10 4.41 MB
175 <none> <none> 12515a2658dc Jun 13, 2018 15:52 4.41 MB
176 <none> <none> fcc3ddd28930 Jun 13, 2018 15:52 4.41 MB
177 <none> <none> 8c6e16890c2b Jun 13, 2018 15:52 4.42 MB
178 localhost/test latest c0cfe75da054 Jun 13, 2018 15:52 4.42 MB
179
180
181
182 # buildah images --format '{{.ID}} {{.CreatedAtRaw}}'
183 3f53bb00af943dfdf815650be70c0fa7b426e56a66f5e3362b47a129d57d5991 2018-12-20 19:21:30.122610396 -0500 EST
184 8e09da8f6701d7cde1526d79e3123b0f1109b78d925dfe9f9bac6d59d702a390 2019-01-08 09:22:52.330623532 -0500 EST
185
186
187
188 # buildah images --format '{{.ID}} {{.Name}} {{.Digest}} {{.CreatedAt}} {{.Size}} {{.CreatedAtRaw}}'
189 3f53bb00af943dfdf815650be70c0fa7b426e56a66f5e3362b47a129d57d5991 docker.io/library/alpine sha256:3d2e482b82608d153a374df3357c0291589a61cc194ec4a9ca2381073a17f58e Dec 20, 2018 19:21 4.67 MB 2018-12-20 19:21:30.122610396 -0500 EST
190 8e09da8f6701d7cde1526d79e3123b0f1109b78d925dfe9f9bac6d59d702a390 <none> sha256:894532ec56e0205ce68ca7230b00c18aa3c8ee39fcdb310615c60e813057229c Jan 8, 2019 09:22 4.67 MB 2019-01-08 09:22:52.330623532 -0500 EST
191
192
193
195 buildah(1), containers-storage.conf(5)
196
197
198
199buildah March 2017 buildah-images(1)