FreeBSD Manual Pages
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 (unused) | | | 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 la- | | | bel!=[...] 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 <im- age@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 image. They are de- noted 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 chil- dren. 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 for- mat is the label!=key or label!=key=value, which shows images without the specified labels. The readonly filter accepts true or false. The reference filter accepts regex expressions like image:.*-alpine. The after/since filter accepts formats: <image-name>[:<tag>], <image id> or <image@digest>. The until filter shows images created before the given date/time. The <timestamp> can be Unix timestamps, date formatted timestamps (e.g. 2020-12-31, 2021-01-01T10:00:00), or Go duration strings (e.g. 10m, 1h30m). 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 for- mat is the label!=key or label!=key=value, which shows images without 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 im- ages. Read-only images can be configured by modifying the additionalimage- stores 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 sort- ing by repository it also sorts by the tag as second criteria to provide a stable output. EXAMPLES 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, includ- ing 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)
NAME | SYNOPSIS | DESCRIPTION | OPTIONS | EXAMPLES | SEE ALSO | HISTORY
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+15.1.quarterly>