toolbox-rmi(1)              General Commands Manual             toolbox-rmi(1)

NAME
       toolbox-rmi - Remove one or more toolbox images


SYNOPSIS
       toolbox rmi [--all | -a] [--force | -f] [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 conjunction 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:36
       $ toolbox rmi localhost/fedora-toolbox-gegl:36



   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
       toolbox(1), podman(1), podman-rmi(1)

                                                                toolbox-rmi(1)