1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52
|
% 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)`
|