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
16 local 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 []). Valid key‐
36 words are 'before', 'dangling', 'label', 'readonly' and 'since' .
37
38
39 Filters:
40
41
42 before==TIMESTRING
43 Filter on images created before the given time.Time.
44
45
46 dangling=true|false
47 Show dangling images. Dangling images are a file system layer that
48 was used in a previous build of an image and is no longer referenced by
49 any active images. They are denoted with the tag, consume disk space
50 and serve no active purpose.
51
52
53 label
54 Filter by images labels key and/or value.
55
56
57 readonly=true|false
58 Show only read only images or Read/Write images. The default is to
59 show both. Read/Only images can be configured by modifying the "addi‐
60 tionalimagestores" in the /etc/containers/storage.conf file.
61
62
63 since==TIMESTRING
64 Filter on images created since the given time.Time.
65
66
67 --format="TEMPLATE"
68
69
70 Pretty-print images using a Go template.
71
72
73 Valid placeholders for the Go template are listed below:
74
75
76 ┌──────────────┬────────────────────────────────┐
77 │Placeholder │ Description │
78 ├──────────────┼────────────────────────────────┤
79 │.ID │ Image ID │
80 ├──────────────┼────────────────────────────────┤
81 │.Name │ Image Name │
82 ├──────────────┼────────────────────────────────┤
83 │.Digest │ Image Digest │
84 ├──────────────┼────────────────────────────────┤
85 │.CreatedAt │ Creation date Pretty Formatted │
86 ├──────────────┼────────────────────────────────┤
87 │.Size │ Image Size │
88 ├──────────────┼────────────────────────────────┤
89 │.CreatedAtRaw │ Creation date in raw format │
90 ├──────────────┼────────────────────────────────┤
91 │.ReadOnly │ Indicates if image came from a │
92 │ │ R/O store │
93 ├──────────────┼────────────────────────────────┤
94 │ │ │
95 └──────────────┴────────────────────────────────┘
96
97 --history
98
99
100 Display the image name history.
101
102
103 --json
104
105
106 Display the output in JSON format.
107
108
109 --noheading, -n
110
111
112 Omit the table headings from the listing of images.
113
114
115 --no-trunc
116
117
118 Do not truncate output.
119
120
121 --quiet, -q
122
123
124 Displays only the image IDs.
125
126
128 buildah images
129
130
131 buildah images fedora:latest
132
133
134 buildah images --json
135
136
137 buildah images --quiet
138
139
140 buildah images -q --noheading --no-trunc
141
142
143 buildah images --quiet fedora:latest
144
145
146 buildah images --filter dangling=true
147
148
149 buildah images --format "ImageID: {{.ID}}"
150
151
152 # buildah images
153 IMAGE NAME IMAGE TAG IMAGE ID CREATED AT SIZE
154 docker.io/library/alpine latest 3fd9065eaf02 Jan 9, 2018 16:10 4.41 MB
155 localhost/test latest c0cfe75da054 Jun 13, 2018 15:52 4.42 MB
156
157
158
159 # buildah images -a
160 IMAGE NAME IMAGE TAG IMAGE ID CREATED AT SIZE
161 docker.io/library/alpine latest 3fd9065eaf02 Jan 9, 2018 16:10 4.41 MB
162 <none> <none> 12515a2658dc Jun 13, 2018 15:52 4.41 MB
163 <none> <none> fcc3ddd28930 Jun 13, 2018 15:52 4.41 MB
164 <none> <none> 8c6e16890c2b Jun 13, 2018 15:52 4.42 MB
165 localhost/test latest c0cfe75da054 Jun 13, 2018 15:52 4.42 MB
166
167
168
169 # buildah images --format '{{.ID}} {{.CreatedAtRaw}}'
170 3f53bb00af943dfdf815650be70c0fa7b426e56a66f5e3362b47a129d57d5991 2018-12-20 19:21:30.122610396 -0500 EST
171 8e09da8f6701d7cde1526d79e3123b0f1109b78d925dfe9f9bac6d59d702a390 2019-01-08 09:22:52.330623532 -0500 EST
172
173
174
175 # buildah images --format '{{.ID}} {{.Name}} {{.Digest}} {{.CreatedAt}} {{.Size}} {{.CreatedAtRaw}}'
176 3f53bb00af943dfdf815650be70c0fa7b426e56a66f5e3362b47a129d57d5991 docker.io/library/alpine sha256:3d2e482b82608d153a374df3357c0291589a61cc194ec4a9ca2381073a17f58e Dec 20, 2018 19:21 4.67 MB 2018-12-20 19:21:30.122610396 -0500 EST
177 8e09da8f6701d7cde1526d79e3123b0f1109b78d925dfe9f9bac6d59d702a390 <none> sha256:894532ec56e0205ce68ca7230b00c18aa3c8ee39fcdb310615c60e813057229c Jan 8, 2019 09:22 4.67 MB 2019-01-08 09:22:52.330623532 -0500 EST
178
179
180
182 buildah(1), containers-storage.conf(5)
183
184
185
186buildah March 2017 buildah-images(1)