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 local 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 indermediate 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  "additionalimagestores" in the
       /etc/containers/storage.conf file.

       reference=reference
           Show  images  matching  the  specified  reference.  Wildcards  are  supported   (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)