---
name: "docker-artifact-ls"
section: "1"
platform: "linux"
package: "podman-docker"
version: "6.1.4-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/podman-artifact-ls"
---

# docker-artifact-ls(1)

List OCI artifacts in local store (alias list)

Part of [podman-artifact-ls(1)](/podman-artifact-ls/1.md).

## 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⟩