buildah-images(1)

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       ┌──────────────┬────────────────────────────────┐
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       --history
96
97
98       Display the image name history.
99
100
101       --json
102
103
104       Display the output in JSON format.
105
106
107       --noheading, -n
108
109
110       Omit the table headings from the listing of images.
111
112
113       --no-trunc, --notruncate
114
115
116       Do not truncate output.
117
118
119       --quiet, -q
120
121
122       Displays only the image IDs.
123
124

EXAMPLE

126       buildah images
127
128
129       buildah images fedora:latest
130
131
132       buildah images --json
133
134
135       buildah images --quiet
136
137
138       buildah images -q --noheading --notruncate
139
140
141       buildah images --quiet fedora:latest
142
143
144       buildah images --filter dangling=true
145
146
147       buildah images --format "ImageID: {{.ID}}"
148
149
150              # buildah images
151              IMAGE NAME                                               IMAGE TAG            IMAGE ID             CREATED AT             SIZE
152              docker.io/library/alpine                                 latest               3fd9065eaf02         Jan 9, 2018 16:10      4.41 MB
153              localhost/test                                           latest               c0cfe75da054         Jun 13, 2018 15:52     4.42 MB
154
155
156
157              # buildah images -a
158              IMAGE NAME                                               IMAGE TAG            IMAGE ID             CREATED AT             SIZE
159              docker.io/library/alpine                                 latest               3fd9065eaf02         Jan 9, 2018 16:10      4.41 MB
160              <none>                                                   <none>               12515a2658dc         Jun 13, 2018 15:52     4.41 MB
161              <none>                                                   <none>               fcc3ddd28930         Jun 13, 2018 15:52     4.41 MB
162              <none>                                                   <none>               8c6e16890c2b         Jun 13, 2018 15:52     4.42 MB
163              localhost/test                                           latest               c0cfe75da054         Jun 13, 2018 15:52     4.42 MB
164
165
166
167              # buildah images --format '{{.ID}} {{.CreatedAtRaw}}'
168              3f53bb00af943dfdf815650be70c0fa7b426e56a66f5e3362b47a129d57d5991 2018-12-20 19:21:30.122610396 -0500 EST
169              8e09da8f6701d7cde1526d79e3123b0f1109b78d925dfe9f9bac6d59d702a390 2019-01-08 09:22:52.330623532 -0500 EST
170
171
172
173              # buildah images --format '{{.ID}} {{.Name}} {{.Digest}} {{.CreatedAt}} {{.Size}} {{.CreatedAtRaw}}'
174              3f53bb00af943dfdf815650be70c0fa7b426e56a66f5e3362b47a129d57d5991 docker.io/library/alpine sha256:3d2e482b82608d153a374df3357c0291589a61cc194ec4a9ca2381073a17f58e Dec 20, 2018 19:21 4.67 MB 2018-12-20 19:21:30.122610396 -0500 EST
175              8e09da8f6701d7cde1526d79e3123b0f1109b78d925dfe9f9bac6d59d702a390 <none> sha256:894532ec56e0205ce68ca7230b00c18aa3c8ee39fcdb310615c60e813057229c Jan 8, 2019 09:22 4.67 MB 2019-01-08 09:22:52.330623532 -0500 EST
176
177
178

NAME

SYNOPSIS

DESCRIPTION

OPTIONS

EXAMPLE

SEE ALSO