.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 \fB\fCtoolbox create\fR command.

.PP
A toolbox image is an OCI image. Therefore, \fB\fCtoolbox rmi\fR can be used
interchangeably with \fB\fCpodman 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\fC--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 \fB\fClocalhost/fedora-toolbox-gegl:36\fR
.PP
.RS

.nf
$ toolbox rmi localhost/fedora-toolbox-gegl:36

.fi
.RE

.SS Remove all toolbox images, but not those that are used by containers
.PP
.RS

.nf
$ toolbox rmi --all

.fi
.RE

.SS Remove all toolbox images and their dependent containers
.PP
.RS

.nf
$ toolbox rmi --all --force

.fi
.RE

.SH SEE ALSO
.PP
\fB\fCtoolbox(1)\fR, \fB\fCpodman(1)\fR, \fB\fCpodman-rmi(1)\fR