toolbox-rm

Remove a toolbox container

$ toolbox rm [container_name]

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

$ toolbox rm [[-f|--force]] [container_name]

toolbox rm [OPTIONS] CONTAINER_NAME...
toolbox rm [OPTIONS] --all

CONTAINER_NAME...
    Specify one or more names of the toolbox containers to be removed.

-a, --all
    Remove all existing toolbox containers.

-f, --force
    Force the removal of a running toolbox container without confirmation.

-h, --help
    Display a help message and exit.

-v, --verbose
    Print verbose output during the removal process.

toolbox-rm is a utility command used to remove one or more existing Toolbox containers. A Toolbox container provides a reproducible development environment, especially useful on immutable operating systems like Fedora Silverblue or CoreOS.

When you remove a toolbox container, all its contents, including files, installed applications, and configuration, are permanently deleted. This operation is irreversible and frees up disk space.

By default, toolbox-rm will not remove a running container unless the --force option is used. It's crucial to ensure you have backed up any necessary data before proceeding with the removal.

All data stored within the removed toolbox container will be permanently lost. This operation is irreversible.

Removing a running container requires the --force (-f) option. Without it, the command will fail or prompt for confirmation.

Using the --all (-a) option will delete every toolbox container on your system, so use with extreme caution.

By default, toolbox-rm will prompt for confirmation before deleting a container, unless the --force option is specified or standard input is not a TTY.

Toolbox containers are designed for development environments, and while you can mount external directories, their internal state is ephemeral. Ensure critical data is synchronized or backed up outside the container before removal.

The Toolbox project was initiated to facilitate development on immutable Linux distributions, such as Fedora Silverblue and CoreOS, where the root filesystem is read-only. toolbox-rm is an integral part of managing these development environments, allowing users to clean up or reset their containerized workspaces. It evolved from similar concepts within the atomic host ecosystem.

toolbox(1), toolbox-create(1), toolbox-enter(1), toolbox-list(1), podman(1)