buildah-images

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 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/contain‐
   ers/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