.nh
.TH toolbox-rmi 1
.SH NAME
.PP
toolbox-rmi - Remove one or more Toolbx 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 Toolbx images from the host. The image should have been
created using the \fBtoolbox create\fR command.

.PP
A Toolbx 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 Toolbx images. It can be used in conjunction with \fB--force\fR as well.

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

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

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

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

.SS Remove all Toolbx 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