324 lines
10 KiB
Groff
324 lines
10 KiB
Groff
'\" t
|
|
.nh
|
|
.TH podman-images 1
|
|
.SH NAME
|
|
podman-images \- List images in local storage
|
|
|
|
.SH SYNOPSIS
|
|
\fBpodman images\fP [\fIoptions\fP] [image]
|
|
|
|
.PP
|
|
\fBpodman image list\fP [\fIoptions\fP] [image]
|
|
|
|
.PP
|
|
\fBpodman image ls\fP [\fIoptions\fP] [image]
|
|
|
|
.SH DESCRIPTION
|
|
Displays locally stored images, their names, and their IDs.
|
|
|
|
.SH OPTIONS
|
|
.SS \fB--all\fP, \fB-a\fP
|
|
Show all images (by default filter out the intermediate image layers). The default is false.
|
|
|
|
.SS \fB--digests\fP
|
|
Show image digests
|
|
|
|
.SS \fB--filter\fP, \fB-f\fP=\fIfilter\fP
|
|
Provide filter values.
|
|
|
|
.PP
|
|
The \fIfilters\fP argument format is of \fBkey=value\fR or \fBkey!=value\fR\&. If there is more than one \fIfilter\fP, then pass multiple OPTIONS: \fB--filter\fP \fIfoo=bar\fP \fB--filter\fP \fIbif=baz\fP\&.
|
|
|
|
.PP
|
|
Supported filters:
|
|
|
|
.TS
|
|
allbox;
|
|
l l
|
|
l l .
|
|
\fBFilter\fP \fBDescription\fP
|
|
id Filter by image ID.
|
|
before T{
|
|
Filter by images created before the given IMAGE (name or tag).
|
|
T}
|
|
containers T{
|
|
Filter by images with a running container.
|
|
T}
|
|
dangling T{
|
|
Filter by dangling (unused) images.
|
|
T}
|
|
digest Filter by digest.
|
|
intermediate T{
|
|
Filter by images that are dangling and have no children
|
|
T}
|
|
label T{
|
|
Filter by images with (or without, in the case of label!=[...] is used) the specified labels.
|
|
T}
|
|
manifest T{
|
|
Filter by images that are manifest lists.
|
|
T}
|
|
readonly T{
|
|
Filter by read-only or read/write images.
|
|
T}
|
|
reference Filter by image name.
|
|
after/since T{
|
|
Filter by images created after the given IMAGE (name or tag).
|
|
T}
|
|
until T{
|
|
Filter by images created until the given duration or time.
|
|
T}
|
|
.TE
|
|
|
|
.PP
|
|
The \fBid\fR \fIfilter\fP accepts the image ID string.
|
|
|
|
.PP
|
|
The \fBbefore\fR \fIfilter\fP accepts formats: \fB<image-name>[:<tag>]\fR, \fB<image id>\fR or \fB<image@digest>\fR\&.
|
|
|
|
.PP
|
|
The \fBcontainers\fR \fIfilter\fP shows images that have a running container based on that image.
|
|
|
|
.PP
|
|
The \fBdangling\fR \fIfilter\fP 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 denoted with the \fB<none>\fR tag, consume disk space and serve no active purpose.
|
|
|
|
.PP
|
|
The \fBdigest\fR \fIfilter\fP accepts the image digest string.
|
|
|
|
.PP
|
|
The \fBintermediate\fR \fIfilter\fP shows images that are dangling and have no children.
|
|
|
|
.PP
|
|
The \fBlabel\fR \fIfilter\fP accepts two formats. One is the \fBlabel\fR=\fIkey\fP or \fBlabel\fR=\fIkey\fP=\fIvalue\fP, which shows images with the specified labels. The other format is the \fBlabel!\fR=\fIkey\fP or \fBlabel!\fR=\fIkey\fP=\fIvalue\fP, which shows images without the specified labels.
|
|
|
|
.PP
|
|
The \fBmanifest\fR \fIfilter\fP shows images that are manifest lists.
|
|
|
|
.PP
|
|
The \fBreadonly\fR \fIfilter\fP shows, as a default, both read-only and read/write images. Read-only images can be configured by modifying the \fBadditionalimagestores\fR in the \fB/etc/containers/storage.conf\fR file.
|
|
|
|
.PP
|
|
The \fBreference\fR \fIfilter\fP accepts the pattern of an image reference \fB<image-name>[:<tag>]\fR\&.
|
|
|
|
.PP
|
|
The \fBafter\fR or \fBsince\fR \fIfilter\fP accepts formats: \fB<image-name>[:<tag>]\fR, \fB<image id>\fR or \fB<image@digest>\fR\&.
|
|
|
|
.PP
|
|
The \fBuntil\fR \fIfilter\fP accepts formats: golang duration, RFC3339 time, or a Unix timestamp and shows all images that are created until that time.
|
|
|
|
.SS \fB--format\fP=\fIformat\fP
|
|
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:
|
|
|
|
.TS
|
|
allbox;
|
|
l l
|
|
l l .
|
|
\fB\fBPlaceholder\fP\fP \fB\fBDescription\fP\fP
|
|
\&.Containers T{
|
|
Number of containers using this image
|
|
T}
|
|
\&.Created T{
|
|
Elapsed time since the image was created
|
|
T}
|
|
\&.CreatedAt T{
|
|
Time when the image was created, YYYY-MM-DD HH:MM:SS +nnnn
|
|
T}
|
|
\&.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 T{
|
|
Is image dangling? (true/false)
|
|
T}
|
|
\&.IsReadOnly T{
|
|
Is unage read-only? (true/false)
|
|
T}
|
|
\&.Labels ... map[] of labels
|
|
\&.Names Image FQIN
|
|
\&.ParentId T{
|
|
Full SHA of parent image ID, or null (string)
|
|
T}
|
|
\&.ReadOnly Same as .IsReadOnly
|
|
\&.RepoDigests T{
|
|
map[] of zero or more repo/name@sha256:SHA strings
|
|
T}
|
|
\&.Repository Image repository
|
|
\&.RepoTags T{
|
|
map[] of zero or more FQIN strings for this image
|
|
T}
|
|
\&.SharedSize Always seems to be 0
|
|
\&.Size T{
|
|
Size of layer on disk (human-friendly string)
|
|
T}
|
|
\&.Tag Image tag
|
|
\&.VirtualSize Size of layer on disk (bytes)
|
|
.TE
|
|
|
|
.SS \fB--history\fP
|
|
Display the history of image names. If an image gets re-tagged or untagged, 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.
|
|
|
|
.SS \fB--no-trunc\fP
|
|
Do not truncate the output (default \fIfalse\fP).
|
|
|
|
.SS \fB--noheading\fP, \fB-n\fP
|
|
Omit the table headings from the listing.
|
|
|
|
.SS \fB--quiet\fP, \fB-q\fP
|
|
Lists only the image IDs.
|
|
|
|
.SS \fB--sort\fP=\fIsort\fP
|
|
Sort by \fIcreated\fP, \fIid\fP, \fIrepository\fP, \fIsize\fP or \fItag\fP (default: \fBcreated\fP)
|
|
When sorting by \fIrepository\fP it also sorts by the \fItag\fP as second criteria to provide a stable output.
|
|
|
|
.SH EXAMPLES
|
|
List all non-dangling images in local storage:
|
|
|
|
.EX
|
|
$ 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
|
|
.EE
|
|
|
|
.PP
|
|
List all images matching the specified name:
|
|
|
|
.EX
|
|
$ podman images stable
|
|
REPOSITORY TAG IMAGE ID CREATED SIZE
|
|
quay.io/podman/stable latest e0b7dabc3352 22 hours ago 331 MB
|
|
.EE
|
|
|
|
.PP
|
|
List image ids of all images in containers storage:
|
|
|
|
.EX
|
|
# podman image ls --quiet
|
|
e3d42bcaf643
|
|
ebb91b73692b
|
|
4526339ae51c
|
|
.EE
|
|
|
|
.PP
|
|
List all images without showing the headers:
|
|
|
|
.EX
|
|
# 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
|
|
.EE
|
|
|
|
.PP
|
|
List all images without truncating output:
|
|
|
|
.EX
|
|
# 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
|
|
.EE
|
|
|
|
.PP
|
|
List all image content with the formatted content:
|
|
|
|
.EX
|
|
# 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
|
|
.EE
|
|
|
|
.PP
|
|
List any image that is not tagged with a name (dangling):
|
|
|
|
.EX
|
|
# podman images --filter dangling=true
|
|
REPOSITORY TAG IMAGE ID CREATED SIZE
|
|
<none> <none> ebb91b73692b 4 weeks ago 27.2 MB
|
|
.EE
|
|
|
|
.PP
|
|
List all images in JSON format:
|
|
|
|
.EX
|
|
# 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
|
|
}
|
|
]
|
|
.EE
|
|
|
|
.PP
|
|
List all images sorted by the specified column:
|
|
|
|
.EX
|
|
# 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
|
|
.EE
|
|
|
|
.PP
|
|
Show the difference between listed images in use versus all images, including dangling images:
|
|
|
|
.EX
|
|
# 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
|
|
.EE
|
|
|
|
.SH SEE ALSO
|
|
\fBpodman(1)\fP, \fBcontainers-storage.conf(5)\fP
|
|
|
|
.SS Troubleshooting
|
|
See podman-troubleshooting(7)
|
|
for solutions to common issues.
|
|
|
|
.SH HISTORY
|
|
March 2017, Originally compiled by Dan Walsh \fB<dwalsh@redhat.com>\fR
|