.nh
.TH podman-rmi 1
.SH NAME
.PP
podman-rmi - Remove one or more locally stored images

.SH SYNOPSIS
.PP
\fBpodman rmi\fP [\fIoptions\fP] \fIimage\fP [...]

.PP
\fBpodman image rm\fP [\fIoptions\fP] \fIimage\fP [...]

.SH DESCRIPTION
.PP
Removes one or more locally stored images.
Passing an argument \fIimage\fP deletes it, along with any of its dangling parent images.  A dangling image is an image without a tag and without being referenced by another image.

.PP
Note: To delete an image from a remote registry, use the \fBskopeo delete\fP command. Some registries do not allow users to delete an image via a CLI remotely.

.SH OPTIONS
.SS \fB--all\fP, \fB-a\fP
.PP
Remove all images in the local storage.

.SS \fB--force\fP, \fB-f\fP
.PP
This option causes Podman to remove all containers that are using the image before removing the image from the system.

.SS \fB--ignore\fP, \fB-i\fP
.PP
If a specified image does not exist in the local storage, ignore it and do not throw an error.

.SS \fB--no-prune\fP
.PP
This option does not remove dangling parents of the specified image.

.PP
Remove an image by its short ID

.EX
$ podman rmi c0ed59d05ff7
.EE

.PP
Remove an image and its associated containers.

.EX
$ podman rmi --force imageID
.EE

.PP
Remove multiple images by their shortened IDs.

.EX
$ podman rmi c4dfb1609ee2 93fd78260bd1 c0ed59d05ff7
.EE

.PP
Remove all images and containers.

.EX
$ podman rmi -a -f
.EE

.PP
Remove an absent image with and without the \fB--ignore\fR flag.

.EX
$ podman rmi --ignore nothing
$ podman rmi nothing
Error: nothing: image not known

.EE

.SH Exit Status
.PP
\fB0\fP   All specified images removed

.PP
\fB1\fP   One of the specified images did not exist, and no other failures

.PP
\fB2\fP   One of the specified images has child images or is being used by a container

.PP
\fB125\fP The command fails for any other reason

.SH SEE ALSO
.PP
\fBpodman(1)\fP, \fBskopeo-delete(1)\fP

.SH HISTORY
.PP
March 2017, Originally compiled by Dan Walsh dwalsh@redhat.com
\[la]mailto:dwalsh@redhat.com\[ra]