.nh
.TH toolbox-rmi 1
.SH NAME
.PP
toolbox-rmi - Remove one or more toolbox images

.SH SYNOPSIS
.PP
\fBtoolbox rmi\fP [\fI--all\fP | \fI-a\fP] [\fI--force\fP | \fI-f\fP] [\fIIMAGE\fP\&...]

.SH DESCRIPTION
.PP
Removes one or more toolbox images from the host. The image should have been
created using the \fBtoolbox create\fR command.

.PP
A toolbox image is an OCI image. Therefore, \fBtoolbox rmi\fR can be used
interchangeably with \fBpodman rmi\fR\&.

.SH OPTIONS
.PP
The following options are understood:

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

.PP
Remove all toolbox images. It can be used in conjunction with \fB--force\fR as well.

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

.PP
Force the removal of toolbox images that are used by toolbox containers. The
dependent containers will be removed as well.

.SH EXAMPLES
.SS Remove a toolbox image named \fBlocalhost/fedora-toolbox-gegl:36\fR
.EX
$ toolbox rmi localhost/fedora-toolbox-gegl:36

.EE

.SS Remove all toolbox images, but not those that are used by containers
.EX
$ toolbox rmi --all

.EE

.SS Remove all toolbox images and their dependent containers
.EX
$ toolbox rmi --all --force

.EE

.SH SEE ALSO
.PP
\fBtoolbox(1)\fR, \fBpodman(1)\fR, \fBpodman-rmi(1)\fR