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,
buildah will attempt to find and remove the named image using
the registry name localhost, 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.
• If the imageID refers to a manifest list or image index, this
command will not do what you expect! This command will remove
the images associated with the manifest list or index (not the
manifest 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 con-
tainers using the image as a reference image. An image name or id can-
not be provided when this option is used. Read/Only images configured by
modifying the "additionalimagestores" in the /etc/containers/stor-
age.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 con-
tainer registries should be consulted when completing image names which
do not include a registry or domain portion.
storage.conf (/etc/containers/storage.conf)
storage.conf is the storage configuration file for all tools using con-
tainers/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)
Generated by dwww version 1.16 on Tue Dec 16 05:45:47 CET 2025.