---
name: "toolbox-rmi"
section: "1"
platform: "linux"
package: "toolbox"
version: "0.3-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/toolbox-rmi"
---

# toolbox-rmi(1)

Remove one or more Toolbx images

## NAME

toolbox-rmi - Remove one or more Toolbx images

## SYNOPSIS

**toolbox rmi** \[*--all* \| *-a*\] \[*--force* \| *-f*\] \[*IMAGE*...\]

## DESCRIPTION

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
```

## SEE ALSO

**[toolbox(1)](/toolbox/1.md)**, **[podman(1)](/podman/1.md)**, **[podman-rmi(1)](/podman-rmi/1.md)**