github.com/containers/podman/v5@v5.1.0-rc1/docs/source/markdown/podman-rmi.1.md (about)

     1  % podman-rmi 1
     2  
     3  ## NAME
     4  podman\-rmi - Remove one or more locally stored images
     5  
     6  ## SYNOPSIS
     7  **podman rmi** [*options*] *image* [...]
     8  
     9  **podman image rm** [*options*] *image* [...]
    10  
    11  ## DESCRIPTION
    12  Removes one or more locally stored images.
    13  Passing an argument _image_ 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.
    14  
    15  Note: To delete an image from a remote registry, use the [**skopeo delete**](https://github.com/containers/skopeo/blob/main/docs/skopeo-delete.1.md) command. Some registries do not allow users to delete an image via a CLI remotely.
    16  
    17  ## OPTIONS
    18  
    19  #### **--all**, **-a**
    20  
    21  Remove all images in the local storage.
    22  
    23  #### **--force**, **-f**
    24  
    25  This option causes Podman to remove all containers that are using the image before removing the image from the system.
    26  
    27  #### **--ignore**, **-i**
    28  
    29  If a specified image does not exist in the local storage, ignore it and do not throw an error.
    30  
    31  #### **--no-prune**
    32  
    33  This option does not remove dangling parents of the specified image.
    34  
    35  Remove an image by its short ID
    36  ```
    37  $ podman rmi c0ed59d05ff7
    38  ```
    39  Remove an image and its associated containers.
    40  ```
    41  $ podman rmi --force imageID
    42  ```
    43  
    44  Remove multiple images by their shortened IDs.
    45  ```
    46  $ podman rmi c4dfb1609ee2 93fd78260bd1 c0ed59d05ff7
    47  ```
    48  
    49  Remove all images and containers.
    50  ```
    51  $ podman rmi -a -f
    52  ```
    53  
    54  Remove an absent image with and without the `--ignore` flag.
    55  ```
    56  $ podman rmi --ignore nothing
    57  $ podman rmi nothing
    58  Error: nothing: image not known
    59  
    60  ```
    61  
    62  
    63  ## Exit Status
    64    **0**   All specified images removed
    65  
    66    **1**   One of the specified images did not exist, and no other failures
    67  
    68    **2**   One of the specified images has child images or is being used by a container
    69  
    70    **125** The command fails for any other reason
    71  
    72  ## SEE ALSO
    73  **[podman(1)](podman.1.md)**, **[skopeo-delete(1)](https://github.com/containers/skopeo/blob/main/docs/skopeo-delete.1.md)**
    74  
    75  ## HISTORY
    76  March 2017, Originally compiled by Dan Walsh <dwalsh@redhat.com>