{"id":48448,"date":"2025-02-08T08:38:39","date_gmt":"2025-02-08T08:38:39","guid":{"rendered":"https:\/\/www.devopsschool.com\/blog\/?p=48448"},"modified":"2025-07-12T05:38:41","modified_gmt":"2025-07-12T05:38:41","slug":"docker-rmi","status":"publish","type":"post","link":"https:\/\/www.devopsschool.com\/blog\/docker-rmi\/","title":{"rendered":"Docker commands Guide – docker rmi with examples"},"content":{"rendered":"\n

Here\u2019s a complete tutorial<\/strong> on docker rmi<\/code>, including what it does<\/strong>, examples<\/strong>, and use cases<\/strong>.<\/p>\n\n\n\n

\n\n\n\n

What is docker rmi<\/code>?<\/strong><\/h2>\n\n\n\n

docker rmi<\/code> is a Docker command used to remove Docker images<\/strong> from the local system. It helps in cleaning up unused images<\/strong> and managing disk space. You can remove individual images<\/strong>, multiple images<\/strong>, or dangling images<\/strong> (untagged).<\/p>\n\n\n\n

Key Features:<\/strong><\/h3>\n\n\n\n
    \n
  • Deletes both tagged and untagged images.<\/li>\n\n\n\n
  • Supports removing multiple images<\/strong> at once.<\/li>\n\n\n\n
  • Helps in freeing up disk space<\/strong>.<\/li>\n<\/ul>\n\n\n\n
    \n\n\n\n

    Basic Syntax<\/strong><\/h2>\n\n\n
    docker<\/span> rmi<\/span> [OPTIONS]<\/span> IMAGE<\/span> [IMAGE...]<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
    Options:<\/strong><\/h3>\n\n\n\n
      \n
    • -f<\/code>, --force<\/code>: Force remove an image, even if it\u2019s in use by a stopped container.<\/li>\n\n\n\n
    • --no-prune<\/code>: Do not remove dangling parent images (default is to remove them).<\/li>\n<\/ul>\n\n\n\n
      \n\n\n\n
      Examples of docker rmi<\/code><\/strong><\/h2>\n\n\n\n
      1. Remove a Single Image by Tag<\/strong><\/h3>\n\n\n
      docker<\/span> rmi<\/span> nginx<\/span>:latest<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      This removes the nginx:latest<\/code> image.<\/p>\n\n\n\n
      \n\n\n\n
      2. Remove an Image by ID<\/strong><\/h3>\n\n\n
      docker rmi a1b2c3d4e5f6\n<\/code><\/span><\/pre>\n\n\n
      You can use the image\u2019s unique ID to remove it.<\/p>\n\n\n\n
      \n\n\n\n
      3. Remove Multiple Images<\/strong><\/h3>\n\n\n
      docker<\/span> rmi<\/span> nginx<\/span>:latest<\/span> alpine<\/span>:3.14<\/span> python<\/span>:3.9<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      This removes the specified images in one command.<\/p>\n\n\n\n
      \n\n\n\n
      4. Force Remove an Image (--force<\/code>)<\/strong><\/h3>\n\n\n
      docker<\/span> rmi<\/span> -f<\/span> my_image<\/span>:latest<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      This forcefully removes my_image:latest<\/code>, even if it\u2019s in use by a stopped container.<\/p>\n\n\n\n
      \n\n\n\n
      5. Remove Dangling Images<\/strong><\/h3>\n\n\n\n
      Dangling images are untagged images that are no longer associated with any container.<\/p>\n\n\n
      docker rmi $(docker images -f \"dangling=true\"<\/span> -q)\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      This removes all dangling images.<\/p>\n\n\n\n
      \n\n\n\n
      6. Remove Images Created Before a Specific Image<\/strong><\/h3>\n\n\n
      docker rmi $(docker images --filter \"before=nginx:latest\"<\/span> -q)\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      This removes images created before the nginx:latest<\/code> image.<\/p>\n\n\n\n
      \n\n\n\n
      7. Remove Images Above a Certain Size<\/strong><\/h3>\n\n\n\n
      List images larger than 500MB and remove them:<\/p>\n\n\n
      docker images --filter \"dangling=false\"<\/span> --format \"{{.Repository}}:{{.Tag}} {{.Size}}\"<\/span> | awk '$2+0 > 500 {print $1}'<\/span> | xargs docker rmi\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      \n\n\n\n
      8. Remove All Images<\/strong><\/h3>\n\n\n
      docker rmi $(docker images -q)\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      This removes all images from the local system.<\/p>\n\n\n\n
      Note:<\/strong> Be careful with this command\u2014it removes everything.<\/p>\n\n\n\n
      \n\n\n\n
      9. Remove an Image and Its Parent Images<\/strong><\/h3>\n\n\n\n
      By default, docker rmi<\/code> removes parent images if they are no longer used by other images:<\/p>\n\n\n
      docker<\/span> rmi<\/span> my_custom_image<\/span>:latest<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      \n\n\n\n
      10. Use docker rmi<\/code> in a Cleanup Script<\/strong><\/h3>\n\n\n
      #!\/bin\/bash<\/span>\n# Remove all dangling images<\/span>\ndocker rmi $(docker images -q -f \"dangling=true\"<\/span>)\necho<\/span> \"Cleaned up dangling images.\"<\/span>\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
      \n\n\n\n
      Use Cases for docker rmi<\/code><\/strong><\/h2>\n\n\n\n
      1. Freeing Up Disk Space<\/strong><\/h3>\n\n\n\n
        \n
      • Regularly remove unused and dangling images to reclaim disk space<\/strong>.<\/li>\n\n\n\n
      • Example: Remove large intermediate build images after building the final image.<\/li>\n<\/ul>\n\n\n\n
        2. Cleaning Up After Testing<\/strong><\/h3>\n\n\n\n
          \n
        • Remove temporary or test images after they are no longer needed.<\/li>\n\n\n\n
        • Example: Clean up development images after integration tests.<\/li>\n<\/ul>\n\n\n\n
          3. Managing Image Versions<\/strong><\/h3>\n\n\n\n
            \n
          • Remove outdated versions of images to prevent clutter.<\/li>\n\n\n\n
          • Example: Keep only the latest version of your application image and remove older ones.<\/li>\n<\/ul>\n\n\n\n
            4. Automating Image Cleanup<\/strong><\/h3>\n\n\n\n
              \n
            • Integrate docker rmi<\/code> in CI\/CD pipelines<\/strong> to clean up old or untagged images.<\/li>\n<\/ul>\n\n\n\n
              5. Reducing Build Times<\/strong><\/h3>\n\n\n\n
                \n
              • Remove intermediate build images to reduce storage usage and improve build performance.<\/li>\n<\/ul>\n\n\n\n
                6. Preparing for Disaster Recovery<\/strong><\/h3>\n\n\n\n
                  \n
                • Clean up unused images to simplify backup and recovery processes.<\/li>\n<\/ul>\n\n\n\n
                  \n\n\n\n
                  List of Common docker rmi<\/code> Commands<\/strong><\/h2>\n\n\n\n
                  Command<\/strong><\/th>Description<\/strong><\/th><\/tr><\/thead>
                  docker rmi nginx:latest<\/code><\/td>Remove the nginx:latest<\/code> image<\/td><\/tr>
                  docker rmi a1b2c3d4e5f6<\/code><\/td>Remove an image by ID<\/td><\/tr>
                  docker rmi nginx:latest alpine:3.14 python:3.9<\/code><\/td>Remove multiple images<\/td><\/tr>
                  docker rmi -f my_image:latest<\/code><\/td>Forcefully remove an image<\/td><\/tr>
                  docker rmi $(docker images -f \"dangling=true\" -q)<\/code><\/td>Remove all dangling images<\/td><\/tr>
                  docker rmi $(docker images --filter \"before=nginx:latest\" -q)<\/code><\/td>Remove images created before nginx:latest<\/code><\/td><\/tr>
                  docker rmi $(docker images -q)<\/code><\/td>Remove all images<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
                  \n\n\n\n
                  Best Practices for Using docker rmi<\/code>:<\/strong><\/h2>\n\n\n\n
                    \n
                  1. Check image dependencies<\/strong> before removing to avoid breaking services.<\/li>\n\n\n\n
                  2. Use --filter<\/code> options<\/strong> to safely remove only specific types of images (e.g., dangling).<\/li>\n\n\n\n
                  3. Regularly clean up unused images<\/strong> to avoid filling up disk space.<\/li>\n\n\n\n
                  4. Be careful with docker rmi $(docker images -q)<\/code><\/strong>, as it removes all images.<\/li>\n\n\n\n
                  5. Automate image cleanup<\/strong> in scripts to maintain a clean environment.<\/li>\n<\/ol>\n\n\n\n
                    \n\n\n\n
                    Common Errors and Solutions<\/strong><\/h2>\n\n\n\n
                      \n
                    1. “Image is being used by a running container”<\/strong>
                      \u2192 Stop and remove the container before removing the image: docker stop my_container && docker rm my_container && docker rmi my_image<\/code><\/li>\n\n\n\n
                    2. “No such image”<\/strong>
                      \u2192 Ensure the image exists by checking with docker images<\/code>.<\/li>\n\n\n\n
                    3. “Permission denied”<\/strong>
                      \u2192 Run the command with sudo<\/code> or check user permissions.<\/li>\n\n\n\n
                    4. “Failed to remove parent image”<\/strong>
                      \u2192 The parent image is likely in use by another image. Use docker images --filter<\/code> to identify dependencies.<\/li>\n<\/ol>\n\n\n\n
                      \n\n\n\n
                      Combining docker rmi<\/code> with Other Commands<\/strong><\/h2>\n\n\n\n
                      Clean Up Old Images Automatically<\/strong><\/h3>\n\n\n
                      docker images --filter \"before=my_app:latest\"<\/span> -q | xargs docker rmi\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
                      Clean Up Dangling Images<\/strong><\/h3>\n\n\n
                      docker rmi $(docker images -f \"dangling=true\"<\/span> -q)\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
                      Check Disk Usage Before and After Cleanup<\/strong><\/h3>\n\n\n
                      docker system df\n<\/code><\/span><\/pre>\n\n\n
                      \n\n\n\n
                      <\/p>\n","protected":false},"excerpt":{"rendered":"
                      Here\u2019s a complete tutorial on docker rmi, including what it does, examples, and use cases. What is docker rmi? docker rmi is a Docker command used to remove Docker images… <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"_joinchat":[],"footnotes":""},"categories":[4862],"tags":[],"class_list":["post-48448","post","type-post","status-publish","format-standard","hentry","category-docker"],"_links":{"self":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/48448","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/comments?post=48448"}],"version-history":[{"count":2,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/48448\/revisions"}],"predecessor-version":[{"id":48450,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/48448\/revisions\/48450"}],"wp:attachment":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media?parent=48448"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/categories?post=48448"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/tags?post=48448"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}