Scroll to navigation

podman-artifact-ls(1) General Commands Manual podman-artifact-ls(1)

NAME

podman-artifact-ls - List OCI artifacts in local store

SYNOPSIS

podman artifact ls [options]

DESCRIPTION

List all local artifacts in your local store.

OPTIONS

--format

Print results with a Go template.

Placeholder Description
.Created Elapsed time since the artifact was created
.CreatedAt Full timestamp of when the artifact was created
.Digest The computed digest of the artifact's manifest
.Repository Repository name of the artifact
.Size Size artifact in human readable units
.Tag Tag of the artifact name
.VirtualSize Size of artifact in bytes

--no-trunc

Do not truncate the output (default false).

--noheading, -n

Omit the table headings from the listing.

EXAMPLES

List artifacts in the local store

$ podman artifact ls
REPOSITORY                TAG         DIGEST         CREATED          SIZE
quay.io/artifact/foobar1  latest      ab609fad386d   6 hours ago      2.097GB
quay.io/artifact/foobar2  special     cd734b558ceb   53 seconds ago   12.58MB

List artifacts in the local store without truncating the digest

$ podman artifact ls --no-trunc
REPOSITORY                TAG         DIGEST                                                              CREATED          SIZE
quay.io/artifact/foobar1  latest      ab609fad386df1433f461b0643d9cf575560baf633809dcc9c190da6cc3a3c29    6 hours ago      2.097GB
quay.io/artifact/foobar2  special     cd734b558ceb8ccc0281ca76530e1dea1eb479407d3163f75fb601bffb6f73d0    53 seconds ago   12.58MB

List artifacts in the local store without the title header

$ podman artifact ls --noheading
quay.io/artifact/foobar1  latest      ab609fad386d   6 hours ago      2.097GB
quay.io/artifact/foobar2  special     cd734b558ceb   53 seconds ago   12.58MB

List artifact digests and size using a --format

$ podman artifact ls --format "{{.Digest}} {{.Size}}"
ab609fad386d 2.097GB
cd734b558ceb 12.58MB

SEE ALSO

podman(1), podman-artifact(1)

HISTORY

Jan 2025, Originally compiled by Brent Baude bbaude@redhat.com ⟨mailto:bbaude@redhat.com⟩