buildah-images(1) General Commands Manual buildah-images(1)
NAME
buildah-images - List images in local storage.
SYNOPSIS
buildah images [options] [image]
DESCRIPTION
Displays locally stored images, their names, sizes, created date and
their IDs. The created date is displayed in the time locale of the lo-
cal machine.
OPTIONS
--all, -a
Show all images, including intermediate images from a build.
--digests
Show the image digests.
--filter, -f=[]
Filter output based on conditions provided (default []).
Filters:
after,since=image
Filter on images created since the given image.
before=image
Filter on images created before the given image.
dangling=true|false
Show dangling images. An images is considered to be dangling if it
has no associated names and tags.
id=id
Show image with this specific ID.
intermediate=true|false
Show intermediate images. An images is considered to be an inderme-
diate image if it is dangling and has no children.
label=key[=value]
Filter by images labels key and/or value.
readonly=true|false
Show only read only images or Read/Write images. The default is to
show both. Read/Only images can be configured by modifying the "addi-
tionalimagestores" in the /etc/containers/storage.conf file.
reference=reference
Show images matching the specified reference. Wildcards are sup-
ported (e.g., "reference=fedora:3").
--format="TEMPLATE"
Pretty-print images using a Go template.
Valid placeholders for the Go template are listed below:
┌───────────────┬────────────────────────────────┐
│ Placeholder │ Description │
├───────────────┼────────────────────────────────┤
│ .Created │ Creation date in epoch time │
├───────────────┼────────────────────────────────┤
│ .CreatedAt │ Creation date Pretty Formatted │
├───────────────┼────────────────────────────────┤
│ .CreatedAtRaw │ Creation date in raw format │
├───────────────┼────────────────────────────────┤
│ .Digest │ Image Digest │
├───────────────┼────────────────────────────────┤
│ .ID │ Image ID │
├───────────────┼────────────────────────────────┤
│ .Name │ Image Name │
├───────────────┼────────────────────────────────┤
│ .ReadOnly │ Indicates if image came from a │
│ │ R/O store │
├───────────────┼────────────────────────────────┤
│ .Size │ Image Size │
├───────────────┼────────────────────────────────┤
│ .Tag │ Image Tag │
└───────────────┴────────────────────────────────┘
--history
Display the image name history.
--json
Display the output in JSON format.
--no-trunc
Do not truncate output.
--noheading, -n
Omit the table headings from the listing of images.
--quiet, -q
Displays only the image IDs.
EXAMPLE
buildah images
buildah images fedora:latest
buildah images --json
buildah images --quiet
buildah images -q --noheading --no-trunc
buildah images --quiet fedora:latest
buildah images --filter dangling=true
buildah images --format "ImageID: {{.ID}}"
$ buildah images
REPOSITORY TAG IMAGE ID CREATED SIZE
registry.access.redhat.com/ubi8 latest 53ce4390f2ad 3 weeks ago 233 MB
docker.io/library/busybox latest 16ea53ea7c65 3 weeks ago 1.46 MB
quay.io/libpod/testimage 20210610 9f9ec7f2fdef 4 months ago 7.99 MB
# buildah images -a
IMAGE NAME IMAGE TAG IMAGE ID CREATED AT SIZE
registry.access.redhat.com/ubi8 latest 53ce4390f2ad 3 weeks ago 233 MB
<none> <none> 8c6e16890c2b Jun 13, 2018 15:52 4.42 MB
localhost/test latest c0cfe75da054 Jun 13, 2018 15:52 4.42 MB
# buildah images --format '{{.ID}} {{.CreatedAtRaw}}'
3f53bb00af943dfdf815650be70c0fa7b426e56a66f5e3362b47a129d57d5991 2018-12-20 19:21:30.122610396 -0500 EST
8e09da8f6701d7cde1526d79e3123b0f1109b78d925dfe9f9bac6d59d702a390 2019-01-08 09:22:52.330623532 -0500 EST
# buildah images --format '{{.ID}} {{.Name}} {{.Digest}} {{.CreatedAt}} {{.Size}} {{.CreatedAtRaw}}'
3f53bb00af943dfdf815650be70c0fa7b426e56a66f5e3362b47a129d57d5991 docker.io/library/alpine sha256:3d2e482b82608d153a374df3357c0291589a61cc194ec4a9ca2381073a17f58e Dec 20, 2018 19:21 4.67 MB 2018-12-20 19:21:30.122610396 -0500 EST
8e09da8f6701d7cde1526d79e3123b0f1109b78d925dfe9f9bac6d59d702a390 <none> sha256:894532ec56e0205ce68ca7230b00c18aa3c8ee39fcdb310615c60e813057229c Jan 8, 2019 09:22 4.67 MB 2019-01-08 09:22:52.330623532 -0500 EST
SEE ALSO
buildah(1), containers-storage.conf(5)
buildah March 2017 buildah-images(1)
Generated by dwww version 1.16 on Tue Dec 16 05:45:45 CET 2025.