2019-02-19 15:59:19 +00:00
|
|
|
% 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
|
|
|
|
|
|
2019-03-14 13:06:13 +00:00
|
|
|
`buildah(1)`, `podman(1)`, `podman-rmi(1)`
|
