plucky (1) docker-image-rm.1.gz

Provided by: podman_5.4.0+ds1-1_amd64 bug

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)