github.com/netbrain/docker@v1.9.0-rc2/docs/reference/commandline/rmi.md (about)

     1  <!--[metadata]>
     2  +++
     3  title = "rmi"
     4  description = "The rmi command description and usage"
     5  keywords = ["remove, image, Docker"]
     6  [menu.main]
     7  parent = "smn_cli"
     8  +++
     9  <![end-metadata]-->
    10  
    11  # rmi
    12  
    13      Usage: docker rmi [OPTIONS] IMAGE [IMAGE...]
    14  
    15      Remove one or more images
    16  
    17        -f, --force=false    Force removal of the image
    18        --help=false         Print usage
    19        --no-prune=false     Do not delete untagged parents
    20  
    21  You can remove an image using its short or long ID, its tag, or its digest. If
    22  an image has one or more tag or digest reference, you must remove all of them
    23  before the image is removed.
    24  
    25      $ docker images
    26      REPOSITORY                TAG                 IMAGE ID            CREATED             SIZE
    27      test1                     latest              fd484f19954f        23 seconds ago      7 B (virtual 4.964 MB)
    28      test                      latest              fd484f19954f        23 seconds ago      7 B (virtual 4.964 MB)
    29      test2                     latest              fd484f19954f        23 seconds ago      7 B (virtual 4.964 MB)
    30  
    31      $ docker rmi fd484f19954f
    32      Error: Conflict, cannot delete image fd484f19954f because it is tagged in multiple repositories, use -f to force
    33      2013/12/11 05:47:16 Error: failed to remove one or more images
    34  
    35      $ docker rmi test1
    36      Untagged: test1:latest
    37      $ docker rmi test2
    38      Untagged: test2:latest
    39  
    40      $ docker images
    41      REPOSITORY                TAG                 IMAGE ID            CREATED             SIZE
    42      test                      latest              fd484f19954f        23 seconds ago      7 B (virtual 4.964 MB)
    43      $ docker rmi test
    44      Untagged: test:latest
    45      Deleted: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8
    46  
    47  If you use the `-f` flag and specify the image's short or long ID, then this
    48  command untags and removes all images that match the specified ID.
    49  
    50      $ docker images
    51      REPOSITORY                TAG                 IMAGE ID            CREATED             SIZE
    52      test1                     latest              fd484f19954f        23 seconds ago      7 B (virtual 4.964 MB)
    53      test                      latest              fd484f19954f        23 seconds ago      7 B (virtual 4.964 MB)
    54      test2                     latest              fd484f19954f        23 seconds ago      7 B (virtual 4.964 MB)
    55  
    56      $ docker rmi -f fd484f19954f
    57      Untagged: test1:latest
    58      Untagged: test:latest
    59      Untagged: test2:latest
    60      Deleted: fd484f19954f4920da7ff372b5067f5b7ddb2fd3830cecd17b96ea9e286ba5b8
    61  
    62  An image pulled by digest has no tag associated with it:
    63  
    64      $ docker images --digests
    65      REPOSITORY                     TAG       DIGEST                                                                    IMAGE ID        CREATED         VIRTUAL SIZE
    66      localhost:5000/test/busybox    <none>    sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf   4986bf8c1536    9 weeks ago     2.43 MB
    67  
    68  To remove an image using its digest:
    69  
    70      $ docker rmi localhost:5000/test/busybox@sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf
    71      Untagged: localhost:5000/test/busybox@sha256:cbbf2f9a99b47fc460d422812b6a5adff7dfee951d8fa2e4a98caa0382cfbdbf
    72      Deleted: 4986bf8c15363d1c5d15512d5266f8777bfba4974ac56e3270e7760f6f0a8125
    73      Deleted: ea13149945cb6b1e746bf28032f02e9b5a793523481a0a18645fc77ad53c4ea2
    74      Deleted: df7546f9f060a2268024c8a230d8639878585defcc1bc6f79d2728a13957871b