f2b7e440e1
https://github.com/containers/toolbox/pull/1166 https://github.com/containers/toolbox/pull/1149 Signed-off-by: Nieves Montero <nmontero@redhat.com>
52 lines
1.1 KiB
Markdown
52 lines
1.1 KiB
Markdown
% 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)`
|