Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=podman-rmi&sektion=1&manpath=FreeBSD+Ports+14.3.quarterly>

home | help