podman-artifact-ls(1)

NAME
podman-artifact-ls - List OCI artifacts in local store (alias list)

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.1.md), podman-artifact(1)(podman-artifact.1.md)

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