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)