.nh
.TH buildah-rmi "1" "March 2017" "buildah"
.SH NAME
.PP
buildah-rmi - Removes one or more images.

.SH SYNOPSIS
.PP
\fBbuildah rmi\fP [\fIimage\fP ...]

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

.SH LIMITATIONS
.RS
.IP \(bu 2
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.
.IP \(bu 2
If \fIimageID\fP is a name, but does not include a registry name, buildah will
attempt to find and remove the named image using the registry name \fIlocalhost\fP,
if no such image is found, it will search for the intended image by attempting
to expand the given name using the names of registries provided in the system's
registries configuration file, registries.conf.
.IP \(bu 2
If the \fIimageID\fP refers to a \fImanifest list\fP or \fIimage index\fP, this command
will \fB\fInot\fP\fP do what you expect!  This command will remove the images
associated with the \fImanifest list\fP or \fIindex\fP (not the manifest list/image index
itself). To remove that, use the \fBbuildah manifest rm\fR subcommand instead.

.RE

.SH OPTIONS
.PP
\fB--all\fP, \fB-a\fP

.PP
All local images will be removed from the system that do not have containers 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.

.PP
\fB--force\fP, \fB-f\fP

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

.PP
\fB--prune\fP, \fB-p\fP

.PP
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.

.SH EXAMPLE
.PP
buildah rmi imageID

.PP
buildah rmi --all

.PP
buildah rmi --all --force

.PP
buildah rmi --prune

.PP
buildah rmi --force imageID

.PP
buildah rmi imageID1 imageID2 imageID3

.SH Files
.PP
\fBregistries.conf\fP (\fB/etc/containers/registries.conf\fR)

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

.PP
\fBstorage.conf\fP (\fB/etc/containers/storage.conf\fR)

.PP
storage.conf is the storage configuration file for all tools using containers/storage

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

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