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
16       local 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 []).  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       ┌──────────────┬────────────────────────────────┐
77Placeholder   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

EXAMPLE

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

SEE ALSO

182       buildah(1), containers-storage.conf(5)
183
184
185
186buildah                           March 2017                 buildah-images(1)
Impressum