% toolbox-rmi(1)

## NAME
toolbox\-rmi - Remove one or more toolbox images

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

## DESCRIPTION

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

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

**--force, -f**

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

## EXAMPLES

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

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

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

```
$ toolbox rmi --all
```

### Remove all toolbox images and their dependent containers

```
$ toolbox rmi --all --force
```

## SEE ALSO

`toolbox(1)`, `podman(1)`, `podman-rmi(1)`