toolbox-rmi
Remove toolbox container images
TLDR
Remove one or more toolbox image
Remove all toolbox images
Force the removal of a toolbox image which is currently being used by a container (the container will be removed as well)
SYNOPSIS
toolbox rmi IMAGE [IMAGE...]
PARAMETERS
IMAGE
The name or ID of the toolbox image to remove.
DESCRIPTION
The `toolbox-rmi` command is used to remove images created by the `toolbox create` command. Toolbox is a tool that helps you isolate command line applications from the host system, primarily by running them inside of a container. `toolbox-rmi` specifically removes the container images generated by toolbox, cleaning up disk space and managing the lifecycle of your toolbox environments. It allows you to remove toolbox images without affecting the host system's software. Removing a toolbox image will delete the root file system that applications were installed to, and all modifications to the files within the toolbox. This is useful when an application is no longer needed or if a clean environment is desired. The command checks for active toolbox containers using the image before removing it, and refuses to remove if any are found to prevent data loss or instability of the host system. `toolbox-rmi` effectively manages and cleans up your toolbox environments.
CAVEATS
Before removing an image, ensure no containers based on that image are running. The command will refuse to remove the image if active containers are found.
EXIT STATUS
The command exits with a status of 0 if the image(s) were successfully removed. It exits with a non-zero status if an error occurred, such as the image not existing or being in use.
HISTORY
Toolbox was created to address the problem of installing development tools directly on the host operating system, which can lead to conflicts and system instability. `toolbox-rmi` came later as a mean to manage the images which are created by the toolbox.
SEE ALSO
toolbox(1), toolbox-create(1), podman(1), docker(1)