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

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)