podman-rmi

podman-rmi(1) General Commands Manual podman-rmi(1)

NAME

   podman-rmi - Remove one or more locally stored images

SYNOPSIS

   podman rmi [options] image [...]

   podman image rm [options] image [...]

DESCRIPTION

   Removes one or more locally stored images.  Passing an argument image deletes it, along with any of its dangling parent images.  A dangling image is an image without a tag and without
   being referenced by another image.

   Note: To delete an image from a remote registry, use the skopeo delete command. Some registries do not allow users to delete an image via a CLI remotely.

OPTIONS --all, -a

   Remove all images in the local storage.

--force, -f

   This option causes Podman to remove all containers that are using the image before removing the image from the system.

--ignore, -i

   If a specified image does not exist in the local storage, ignore it and do not throw an error.

--no-prune

   This option does not remove dangling parents of the specified image.

   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

   Remove an absent image with and without the --ignore flag.

   $ podman rmi --ignore nothing
   $ podman rmi nothing
   Error: nothing: image not known

Exit Status

   0   All specified images removed

   1   One of the specified images did not exist, and no other failures

   2   One of the specified images has child images or is being used by a container

   125 The command fails for any other reason

SEE ALSO

   podman(1), skopeo-delete(1)

HISTORY

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

                                                                                                                                                                             podman-rmi(1)