podman-rmi.1.md

% podman-rmi(1)

NAME

podman-rmi - Removes one or more locally stored images

SYNOPSIS

podman rmi image [...]

podman image rm image [...]

DESCRIPTION

Removes one or more locally stored images.

OPTIONS

-all, -a

Remove all images in the local storage.

--force, -f

This option will cause podman to remove all containers that are using the image before removing the image from the system.

Remove an image by its short ID

podman rmi c0ed59d05ff7

Remove an image and its associated containers.

podman rmi --force imageID

Remove multiple images by their shortened IDs.

podman rmi c4dfb1609ee2 93fd78260bd1 c0ed59d05ff7

Remove all images and containers.

podman rmi -a -f

Exit Status

0 if all specified images removed 1 if one of the specified images did not exist, and no other failures 2 if one of the specified images has child images or is being used by a container 125 if the command fails for a reason other than an image did not exist or is in use

SEE ALSO

podman(1)

HISTORY

March 2017, Originally compiled by Dan Walsh dwalsh@redhat.com