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

FreeBSD Manual Pages

  
 
  

home | help
podman-images(1)	    General Commands Manual	      podman-images(1)

NAME
       podman-images - List images in local storage

SYNOPSIS
       podman images [options] [image]

       podman image list [options] [image]

       podman image ls [options] [image]

DESCRIPTION
       Displays	locally	stored images, their names, and	their IDs.

OPTIONS
   --all, -a
       Show  all images	(by default filter out the intermediate	image layers).
       The default is false.

   --digests
       Show image digests

   --filter, -f=filter
       Provide filter values.

       The filters argument format is of key=value or key!=value. If there  is
       more  than  one	filter,	 then  pass multiple OPTIONS: --filter foo=bar
       --filter	bif=baz.

       Supported filters:

       +--------------+----------------------------+
       | Filter	      |	Description		   |
       +--------------+----------------------------+
       | id	      |	Filter by image	ID.	   |
       +--------------+----------------------------+
       | before	      |	Filter by  images  created |
       |	      |	before	 the  given  IMAGE |
       |	      |	(name or tag).		   |
       +--------------+----------------------------+
       | containers   |	Filter by  images  with	 a |
       |	      |	running	container.	   |
       +--------------+----------------------------+
       | dangling     |	Filter	by  dangling  (un- |
       |	      |	used) images.		   |
       +--------------+----------------------------+
       | digest	      |	Filter by digest.	   |
       +--------------+----------------------------+
       | intermediate |	Filter by images that  are |
       |	      |	dangling and have no chil- |
       |	      |	dren			   |
       +--------------+----------------------------+
       | label	      |	Filter	by images with (or |
       |	      |	without, in  the  case	of |
       |	      |	label!=[...]  is used) the |
       |	      |	specified labels.	   |
       +--------------+----------------------------+
       | manifest     |	Filter by images that  are |
       |	      |	manifest lists.		   |
       +--------------+----------------------------+
       | readonly     |	Filter	 by  read-only	or |
       |	      |	read/write images.	   |
       +--------------+----------------------------+
       | reference    |	Filter by image	name.	   |
       +--------------+----------------------------+
       | after/since  |	Filter by  images  created |
       |	      |	after	the   given  IMAGE |
       |	      |	(name or tag).		   |
       +--------------+----------------------------+
       | until	      |	Filter by  images  created |
       |	      |	until  the  given duration |
       |	      |	or time.		   |
       +--------------+----------------------------+

       The id filter accepts the image ID string.

       The before filter accepts formats: <image-name>[:<tag>],	<image id>  or
       <image@digest>.

       The  containers filter shows images that	have a running container based
       on that image.

       The dangling filter shows images	that are  taking  up  disk  space  and
       serve  no  purpose. Dangling image is a file system layer that was used
       in a previous build of an image and is no longer	referenced by any  im-
       age. They are denoted with the <none> tag, consume disk space and serve
       no active purpose.

       The digest filter accepts the image digest string.

       The  intermediate  filter  shows	 images	 that are dangling and have no
       children.

       The label filter	accepts	two formats.  One  is  the  label=key  or  la-
       bel=key=value,  which shows images with the specified labels. The other
       format is the label!=key	or label!=key=value, which shows images	 with-
       out the specified labels.

       The manifest filter shows images	that are manifest lists.

       The  readonly filter shows, as a	default, both read-only	and read/write
       images. Read-only images	can be configured by modifying the   addition-
       alimagestores in	the /etc/containers/storage.conf file.

       The  reference filter accepts the pattern of an image reference <image-
       name>[:<tag>].

       The after or since filter accepts formats: <image-name>[:<tag>],	<image
       id> or <image@digest>.

       The until filter	accepts	formats: golang	duration, RFC3339 time,	 or  a
       Unix timestamp and shows	all images that	are created until that time.

   --format=format
       Change the default output format.  This can be of a supported type like
       'json'  or  a  Go template.  Valid placeholders for the Go template are
       listed below:

       +---------------+-------------------------------+
       | Placeholder   | Description		       |
       +---------------+-------------------------------+
       | .Containers   | Number	 of  containers	 using |
       |	       | this image		       |
       +---------------+-------------------------------+
       | .Created      | Elapsed  time since the image |
       |	       | was created		       |
       +---------------+-------------------------------+
       | .CreatedAt    | Time when the image was  cre- |
       |	       | ated,	 YYYY-MM-DD   HH:MM:SS |
       |	       | +nnnn			       |
       +---------------+-------------------------------+
       | .CreatedSince | Same as .Created	       |
       +---------------+-------------------------------+
       | .CreatedTime  | Same as .CreatedAt	       |
       +---------------+-------------------------------+
       | .Dangling     | Same as .IsDangling	       |
       +---------------+-------------------------------+
       | .Digest       | Image digest		       |
       +---------------+-------------------------------+
       | .History      | History of the	image layer    |
       +---------------+-------------------------------+
       | .ID	       | Image ID (truncated)	       |
       +---------------+-------------------------------+
       | .Id	       | Image ID (full	SHA)	       |
       +---------------+-------------------------------+
       | .IsDangling   | Is	 image	     dangling? |
       |	       | (true/false)		       |
       +---------------+-------------------------------+
       | .IsReadOnly   | Is	 unage	    read-only? |
       |	       | (true/false)		       |
       +---------------+-------------------------------+
       | .Labels ...   | map[] of labels	       |
       +---------------+-------------------------------+
       | .Names	       | Image FQIN		       |
       +---------------+-------------------------------+
       | .ParentId     | Full SHA of parent image  ID, |
       |	       | or null (string)	       |
       +---------------+-------------------------------+
       | .ReadOnly     | Same as .IsReadOnly	       |
       +---------------+-------------------------------+
       | .RepoDigests  | map[]	 of   zero   or	  more |
       |	       | repo/name@sha256:SHA strings  |
       +---------------+-------------------------------+
       | .Repository   | Image repository	       |
       +---------------+-------------------------------+
       | .RepoTags     | map[] of zero	or  more  FQIN |
       |	       | strings for this image	       |
       +---------------+-------------------------------+
       | .SharedSize   | Always	seems to be 0	       |
       +---------------+-------------------------------+
       | .Size	       | Size of layer on disk (human- |
       |	       | friendly string)	       |
       +---------------+-------------------------------+
       | .Tag	       | Image tag		       |
       +---------------+-------------------------------+
       | .VirtualSize  | Size of layer on disk (bytes) |
       +---------------+-------------------------------+

   --history
       Display	the history of image names.  If	an image gets re-tagged	or un-
       tagged, then the	 image	name  history  gets  prepended	(latest	 image
       first).	 This  is especially useful when undoing a tag operation or an
       image does not contain any name because it has been untagged.

   --no-trunc
       Do not truncate the output (default false).

   --noheading,	-n
       Omit the	table headings from the	listing.

   --quiet, -q
       Lists only the image IDs.

   --sort=sort
       Sort by created,	id, repository,	size or	tag  (default:	created)  When
       sorting	by  repository	it also	sorts by the tag as second criteria to
       provide a stable	output.

EXAMPLE
       List all	non-dangling images in local storage:

       $ podman	images
       REPOSITORY			  TAG	      IMAGE ID	    CREATED	  SIZE
       quay.io/podman/stable		  latest      e0b7dabc3352  22 hours ago  331 MB
       docker.io/library/alpine		  latest      9c6f07244728  5 days ago	  5.83 MB
       registry.fedoraproject.org/fedora  latest      2ecb6df95994  3 weeks ago	  169 MB
       quay.io/libpod/testimage		  20220615    f26aa69bb3f3  2 months ago  8.4 MB

       List all	images matching	the specified name:

       $ podman	images stable
       REPOSITORY	      TAG	  IMAGE	ID	CREATED	      SIZE
       quay.io/podman/stable  latest	  e0b7dabc3352	22 hours ago  331 MB

       List image ids of all images in containers storage:

       # podman	image ls --quiet
       e3d42bcaf643
       ebb91b73692b
       4526339ae51c

       List all	images without showing the headers:

       # podman	images --noheading
       docker.io/kubernetes/pause		    latest   e3d42bcaf643   3 years ago	  251 kB
       <none>					    <none>   ebb91b73692b   4 weeks ago	  27.2 MB
       docker.io/library/ubuntu			    latest   4526339ae51c   6 weeks ago	  126 MB

       List all	images without truncating output:

       # podman	image list --no-trunc
       REPOSITORY				    TAG	     IMAGE ID								       CREATED	     SIZE
       docker.io/kubernetes/pause		    latest   sha256:e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27   3 years ago   251 kB
       <none>					    <none>   sha256:ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9   4 weeks ago   27.2 MB
       docker.io/library/ubuntu			    latest   sha256:4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a   6 weeks ago   126 MB

       List all	image content with the formatted content:

       # podman	images --format	"table {{.ID}} {{.Repository}} {{.Tag}}"
       IMAGE ID	      REPOSITORY				   TAG
       e3d42bcaf643   docker.io/kubernetes/pause		   latest
       ebb91b73692b   <none>					   <none>
       4526339ae51c   docker.io/library/ubuntu			   latest

       List any	image that is not tagged with a	name (dangling):

       # podman	images --filter	dangling=true
       REPOSITORY   TAG	     IMAGE ID	    CREATED	  SIZE
       <none>	    <none>   ebb91b73692b   4 weeks ago	  27.2 MB

       List all	images in JSON format:

       # podman	images --format	json
       [
	   {
	    "id": "e3d42bcaf643097dd1bb0385658ae8cbe100a80f773555c44690d22c25d16b27",
	    "names": [
		"docker.io/kubernetes/pause:latest"
	    ],
	    "digest": "sha256:0aecf73ff86844324847883f2e916d3f6984c5fae3c2f23e91d66f549fe7d423",
	    "created": "2014-07-19T07:02:32.267701596Z",
	    "size": 250665
	   },
	   {
	    "id": "ebb91b73692bd27890685846412ae338d13552165eacf7fcd5f139bfa9c2d6d9",
	    "names": [
		"\u003cnone\u003e"
	    ],
	    "digest": "sha256:ba7e4091d27e8114a205003ca6a768905c3395d961624a2c78873d9526461032",
	    "created": "2017-10-26T03:07:22.796184288Z",
	    "size": 27170520
	   },
	   {
	    "id": "4526339ae51c3cdc97956a7a961c193c39dfc6bd9733b0d762a36c6881b5583a",
	    "names": [
		"docker.io/library/ubuntu:latest"
	    ],
	    "digest": "sha256:193f7734ddd68e0fb24ba9af8c2b673aecb0227b026871f8e932dab45add7753",
	    "created": "2017-10-10T20:59:05.10196344Z",
	    "size": 126085200
	   }
       ]

       List all	images sorted by the specified column:

       # podman	images --sort repository
       REPOSITORY				    TAG	     IMAGE ID	    CREATED	  SIZE
       <none>					   <none>   2460217d76fc   About a minute ago	4.41 MB
       docker.io/library/alpine			   latest   3fd9065eaf02   5 months ago		4.41 MB
       localhost/myapp				   latest   b2e0ad03474a   About a minute ago	4.41 MB
       registry.access.redhat.com/rhel7		   latest   7a840db7f020   2 weeks ago		211 MB
       registry.fedoraproject.org/fedora	   27	    801894bc0e43   6 weeks ago		246 MB

       Show the	difference between listed images in use	versus all images, in-
       cluding dangling	images:

       # podman	images
       REPOSITORY		  TAG	   IMAGE ID	  CREATED	  SIZE
       localhost/test		  latest   18f0c080cd72	  4 seconds ago	  4.42 MB
       docker.io/library/alpine	  latest   3fd9065eaf02	  5 months ago	  4.41 MB
       # podman	images -a
       REPOSITORY		  TAG	   IMAGE ID	  CREATED	  SIZE
       localhost/test		  latest   18f0c080cd72	  6 seconds ago	  4.42 MB
       <none>			  <none>   270e70dc54c0	  7 seconds ago	  4.42 MB
       <none>			  <none>   4ed6fbe43414	  8 seconds ago	  4.41 MB
       <none>			  <none>   6b0df8e71508	  8 seconds ago	  4.41 MB
       docker.io/library/alpine	  latest   3fd9065eaf02	  5 months ago	  4.41 MB

SEE ALSO
       podman(1), containers-storage.conf(5)

   Troubleshooting
       See podman-troubleshooting(7) for solutions to common issues.

HISTORY
       March 2017, Originally compiled by Dan Walsh <dwalsh@redhat.com>

							      podman-images(1)

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

home | help