Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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  ma-
     chine.

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   "additionalim-
     agestores" 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)

buildah 			   March 2017		       buildah-images(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=buildah-images&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help