github.com/containers/podman/v2@v2.2.2-0.20210501105131-c1e07d070c4c/docs/source/markdown/podman-rmi.1.md (about)

     1  % podman-rmi(1)
     2  
     3  ## NAME
     4  podman\-rmi - Removes 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  
    14  ## OPTIONS
    15  
    16  #### **--all**, **-a**
    17  
    18  Remove all images in the local storage.
    19  
    20  #### **--force**, **-f**
    21  
    22  This option will cause podman to remove all containers that are using the image before removing the image from the system.
    23  
    24  
    25  Remove an image by its short ID
    26  ```
    27  $ podman rmi c0ed59d05ff7
    28  ```
    29  Remove an image and its associated containers.
    30  ```
    31  $ podman rmi --force imageID
    32  ```
    33  
    34  Remove multiple images by their shortened IDs.
    35  ```
    36  $ podman rmi c4dfb1609ee2 93fd78260bd1 c0ed59d05ff7
    37  ```
    38  
    39  Remove all images and containers.
    40  ```
    41  $ podman rmi -a -f
    42  ```
    43  ## Exit Status
    44    **0**   All specified images removed
    45  
    46    **1**   One of the specified images did not exist, and no other failures
    47  
    48    **2**   One of the specified images has child images or is being used by a container
    49  
    50    **125** The command fails for any other reason
    51  
    52  ## SEE ALSO
    53  podman(1)
    54  
    55  ## HISTORY
    56  March 2017, Originally compiled by Dan Walsh <dwalsh@redhat.com>