toolbox/doc/toolbox-rmi.1.md

53 lines
1 KiB
Markdown
Raw Normal View History

% toolbox-rmi(1)
## NAME
toolbox\-rmi - Remove one or more toolbox images
## SYNOPSIS
**toolbox rmi** [*--all*] [*--force*] [*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 conjuction 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:30`
```
$ toolbox rmi localhost/fedora-toolbox-gegl:30
```
### 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
`buildah(1)`, `podman(1)`, `podman-rm(1)`