toolbox-rmi(1)

toolbox-rmi1

Remove one or more toolbx images

Usage

toolbox rmi [{--all | -a}] [{--force | -f}] [IMAGE ...]

Overview

Removes one or more Toolbx images from the host. The image should have been created using the toolbox create command.

A Toolbx 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 Toolbx images. It can be used in conjunction with --force as well.

--force, -f

Force the removal of Toolbx images that are used by Toolbx containers. The dependent containers will be removed as well.

Examples

Remove a Toolbx image named localhost/fedora-toolbox-gegl:36

$ toolbox rmi localhost/fedora-toolbox-gegl:36

Remove all Toolbx images, but not those that are used by containers

$ toolbox rmi --all

Remove all Toolbx images and their dependent containers

$ toolbox rmi --all --force

Releases

3 releases since Debian 12 (Bookworm); the text changed 2 times.

  1. 12
  2. 13
  3. Arch

From toolbox 0.3-2 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.