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

FreeBSD Manual Pages

  
 
  

home | help 
buildah-rmi(1)		     General Commands Manual		  buildah-rmi(1)

NAME
     buildah-rmi - Removes one or more images.

SYNOPSIS
     buildah rmi [image ...]

DESCRIPTION
     Removes  one  or  more  locally  stored  images.  Passing an argument image
     deletes it, along with any of its dangling (untagged) parent images.

LIMITATIONS
	    * If the image was pushed to  a  directory	path  using  the  'dir:'
	      transport,  the  rmi  command  can  not remove the image. Instead,
	      standard file system commands should be used.

	    * If imageID is a name, but does not include a registry name,  buil-
	      dah will attempt to find and remove the named image using the reg-
	      istry  name  localhost,  if no such image is found, it will search
	      for the intended image by attempting to expand the given name  us-
	      ing  the	names  of registries provided in the system's registries
	      configuration file, registries.conf.

	    * If the imageID refers to a manifest list or image index, this com-
	      mand will not do what you expect!  This command  will  remove  the
	      images  associated  with the manifest list or index (not the mani-
	      fest list/image index itself). To remove	that,  use  the  buildah
	      manifest rm subcommand instead.

OPTIONS
     --all, -a

     All  local images will be removed from the system that do not have contain-
     ers using the image as a reference image.	An image name or  id  cannot  be
     provided when this option is used. Read/Only images configured by modifying
     the  "additionalimagestores"  in the /etc/containers/storage.conf file, can
     not be removed.

     --force, -f

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

     --prune, -p

     All local images will be removed from the system that do not have a tag and
     do  not have a child image pointing to them.  An image name or id cannot be
     provided when this option is used.

EXAMPLE
     buildah rmi imageID

     buildah rmi --all

     buildah rmi --all --force

     buildah rmi --prune

     buildah rmi --force imageID

     buildah rmi imageID1 imageID2 imageID3

Files
     registries.conf (/etc/containers/registries.conf)

     registries.conf is the configuration file which specifies	which  container
     registries should be consulted when completing image names which do not in-
     clude a registry or domain portion.

     storage.conf (/etc/containers/storage.conf)

     storage.conf is the storage configuration file for all tools using contain-
     ers/storage

     The  storage  configuration  file	specifies all of the available container
     storage options for tools using shared container storage.

SEE ALSO
     buildah(1), containers-registries.conf(5), containers-storage.conf(5)

buildah 			   March 2017			  buildah-rmi(1)

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

home | help