toolbox/doc/toolbox-rmi.1.md

1 KiB

% toolbox-rmi(1)

NAME

toolbox-rmi - Remove one or more toolbox images

SYNOPSIS

toolbox rmi [--all] [--force] [IMAGE...]

DESCRIPTION

Removes one or more toolbox images from the host. The image should have been created using the toolbox create command.

A toolbox image is an OCI image. Therefore, toolbox rmi can be used interchangeably with podman rmi.

OPTIONS

The following options are understood:

--all, -a

Remove all toolbox images. It can be used in conjuction with --force as well.

--force, -f

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

EXAMPLES

Remove a toolbox image named localhost/fedora-toolbox-gegl:30

$ toolbox rmi localhost/fedora-toolbox-gegl:30

Remove all toolbox images, but not those that are used by containers

$ toolbox rmi --all

Remove all toolbox images and their dependent containers

$ toolbox rmi --all --force

SEE ALSO

buildah(1), podman(1), podman-rm(1)