WARNING: Experimental command

       This  command  is  considered experimental and still in development. Inputs, options, and outputs are all
       subject to change.

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                           │
       ├─────────────┼───────────────────────────────────────┤
       │ .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              │
       └─────────────┴───────────────────────────────────────┘

   --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             SIZE
       quay.io/artifact/foobar1  latest      ab609fad386d       2.097GB
       quay.io/artifact/foobar2  special     cd734b558ceb       12.58MB

       List artifacts in the local store without truncating the digest

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

       List artifacts in the local store without the title header

       $ podman artifact ls --noheading
       quay.io/artifact/foobar1  latest      ab609fad386d       2.097GB
       quay.io/artifact/foobar2  special     cd734b558ceb       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⟩

                                                                                           podman-artifact-ls(1)