podman-artifact-ls(1)

📦
version 6.1.4 · 4 versions
, in arch rolling

okay bestie, welcome to podman-artifact-ls(1) from the General Commands Manual — it's the page for listing OCI artifacts in your local store, and yes, the alias is list. let's get into it 🫶✨

🎀 NAME

podman-artifact-ls — list OCI artifacts in local store (alias list). periodt. 💅

✨ SYNOPSIS

podman artifact ls [options]

💖 DESCRIPTION

Lists all local artifacts in your local store. that's the whole vibe. 🌸

🌈 OPTIONS

  • --format — print results with a Go template. here are the placeholders you can use, bestie:
    • .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

📜 HISTORY

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

mwah 💋 — that's the podman-artifact-ls(1) page from the General Commands Manual, with history dated Jan 2025. byeee bestie 🫶🎀

📦 where this page comes from