Files
podman/docs/source/markdown/podman-artifact-rm.1.md
Lewis Roy f38e32760d feat: Add artifact remove --all option
Prior to this commit `artifact remove --all` was not supported on remote
clients.

This patch adds a new artifact API endpoint `artifact/remove` which can
either take a list of artifacts to remove or remove all artifacts by
setting all=true.

This patch removes the temporary warning message in the tunnel interface
implementation of ArtifactRm if `--all` was passed on the command line
and uses the new `artifact/remove` endpoint.

This patch also updates the `artifact remove` command both remote and
local to accept a list of artifacts to remove rather than limiting to
just one.

Signed-off-by: Lewis Roy <lewis@redhat.com>
2025-08-13 23:00:20 +10:00

1.3 KiB

% podman-artifact-rm 1

NAME

podman-artifact-rm - Remove one or more OCI artifacts from local storage

SYNOPSIS

podman artifact rm [options] name

DESCRIPTION

Remove one or more artifacts from the local artifact store. The input may be the fully qualified artifact name or a full or partial artifact digest.

OPTIONS

--all, -a

Remove all artifacts in the local store. The use of this option conflicts with providing a name or digest of the artifact.

--help

Print usage statement.

EXAMPLES

Remove an artifact by name.

$ podman artifact rm quay.io/artifact/foobar2:test
Deleted: e7b417f49fc24fc7ead6485da0ebd5bc4419d8a3f394c169fee5a6f38faa4056

Remove multiple artifacts by their shortened IDs.

$ podman artifact rm c4dfb1609ee2 93fd78260bd1 c0ed59d05ff7

Remove an artifact by partial digest.

$ podman artifact rm e7b417f49fc
Deleted: e7b417f49fc24fc7ead6485da0ebd5bc4419d8a3f394c169fee5a6f38faa4056

Remove all artifacts in local storage.

$ podman artifact rm -a
Deleted: cee15f7c5ce3e86ae6ce60d84bebdc37ad34acfa9a2611cf47501469ac83a1ab
Deleted: 72875f8f6f78d5b8ba98b2dd2c0a6f395fde8f05ff63a1df580d7a88f5afa97b

SEE ALSO

podman(1), podman-artifact(1)

HISTORY

Jan 2025, Originally compiled by Brent Baude bbaude@redhat.com