toolbox-rmi

Remove one or more toolbox image

$ toolbox rmi [image_name1 image_name2 ...]

$ toolbox rmi [[-a|--all]]

$ toolbox rmi [[-f|--force]] [image_name]

toolbox rmi IMAGE [IMAGE...]

IMAGE
    The name or ID of the toolbox image to remove.

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.

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.

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.

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.

toolbox(1), toolbox-create(1), podman(1), docker(1)