LinuxCommandLibrary

toolbox-rmi

Remove toolbox container images

TLDR

Remove one or more toolbox image

$ toolbox rmi [image_name1 image_name2 ...]
copy

Remove all toolbox images
$ toolbox rmi [[-a|--all]]
copy

Force the removal of a toolbox image which is currently being used by a container (the container will be removed as well)
$ toolbox rmi [[-f|--force]] [image_name]
copy

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

Copied to clipboard