{"id":48445,"date":"2025-02-08T08:37:31","date_gmt":"2025-02-08T08:37:31","guid":{"rendered":"https:\/\/www.devopsschool.com\/blog\/?p=48445"},"modified":"2026-02-21T07:25:49","modified_gmt":"2026-02-21T07:25:49","slug":"docker-load","status":"publish","type":"post","link":"https:\/\/www.devopsschool.com\/blog\/docker-load\/","title":{"rendered":"Docker commands Guide – docker load with examples"},"content":{"rendered":"\n

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

\n\n\n\n

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

docker load<\/code> is a Docker command used to load a Docker image<\/strong> from a tarball<\/strong> (image archive file) into the local Docker image repository. It is commonly used for importing images<\/strong> that were saved with the docker save<\/code> command.<\/p>\n\n\n\n

Key Features:<\/strong><\/h3>\n\n\n\n
    \n
  • Restores Docker images from a tar archive.<\/li>\n\n\n\n
  • Useful for transferring images<\/strong> between systems without using a Docker registry.<\/li>\n\n\n\n
  • Supports compressed and uncompressed tar files<\/strong>.<\/li>\n<\/ul>\n\n\n\n
    \n\n\n\n

    Basic Syntax<\/strong><\/h2>\n\n\n
    docker<\/span> load<\/span> [OPTIONS]<\/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
    • -i<\/code>, --input<\/code>: Specify the file to load the image from (instead of standard input).<\/li>\n\n\n\n
    • --quiet<\/code>: Suppress the verbose output during the image load process.<\/li>\n<\/ul>\n\n\n\n
      \n\n\n\n
      Examples of docker load<\/code><\/strong><\/h2>\n\n\n\n
      1. Load an Image from a Tarball<\/strong><\/h3>\n\n\n
      docker<\/span> load<\/span> -i<\/span> my_image<\/span>.tar<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      This loads the image from the tarball my_image.tar<\/code> into the local Docker repository.<\/p>\n\n\n\n
      \n\n\n\n
      2. Load an Image from a Compressed Tarball<\/strong><\/h3>\n\n\n
      gunzip < my_image.tar.gz | docker load\n<\/code><\/span><\/pre>\n\n\n
      This decompresses my_image.tar.gz<\/code> and loads the image into Docker.<\/p>\n\n\n\n
      \n\n\n\n
      3. Load an Image Using Standard Input<\/strong><\/h3>\n\n\n
      cat my_image.tar | docker load\n<\/code><\/span><\/pre>\n\n\n
      This pipes the tarball content directly into docker load<\/code>.<\/p>\n\n\n\n
      \n\n\n\n
      4. Load Multiple Images from a Single Tarball<\/strong><\/h3>\n\n\n
      docker<\/span> load<\/span> -i<\/span> multiple_images<\/span>.tar<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      If the tarball contains multiple images, docker load<\/code> will restore all of them.<\/p>\n\n\n\n
      \n\n\n\n
      5. Use docker load<\/code> in a Script for Automation<\/strong><\/h3>\n\n\n
      #!\/bin\/bash<\/span>\nfor<\/span> tarfile in<\/span> \/backup\/images\/*.tar; do\n  docker load -i $tarfile\n  echo \"Loaded image from $tarfile\"\ndone\n<\/span><\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      This script loads all tar files from the \/backup\/images<\/code> directory into Docker.<\/p>\n\n\n\n
      \n\n\n\n
      6. Load an Image Quietly (Suppress Output)<\/strong><\/h3>\n\n\n
      docker<\/span> load<\/span> --input<\/span> my_image<\/span>.tar<\/span> --quiet<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      This loads the image without showing verbose output.<\/p>\n\n\n\n
      \n\n\n\n
      7. Load an Image with Docker Compose<\/strong><\/h3>\n\n\n\n
      You can combine docker load<\/code> with docker-compose<\/code> in your CI\/CD pipeline:<\/p>\n\n\n
      services<\/span>:\n  web<\/span>:\n    image<\/span>: my_image<\/span>:latest<\/span>\n    build<\/span>:\n      context<\/span>: .\n      hooks<\/span>:\n        post_build<\/span>:\n          -<\/span> docker<\/span> load<\/span> -i<\/span> my_image<\/span>.tar<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      \n\n\n\n
      Use Cases for docker load<\/code><\/strong><\/h2>\n\n\n\n
      1. Image Transfer Between Environments<\/strong><\/h3>\n\n\n\n
        \n
      • Transfer Docker images between development, testing, and production environments<\/strong> without pushing them to a registry.<\/li>\n\n\n\n
      • Example: Move a large image from a build server to production.<\/li>\n<\/ul>\n\n\n\n
        2. Backup and Restore Docker Images<\/strong><\/h3>\n\n\n\n
          \n
        • Save images with docker save<\/code> and restore them later using docker load<\/code>.<\/li>\n\n\n\n
        • Example: Backup custom application images before upgrading Docker or the host system.<\/li>\n<\/ul>\n\n\n\n
          3. Air-Gapped Environments<\/strong><\/h3>\n\n\n\n
            \n
          • Use docker load<\/code> to transfer images in air-gapped networks<\/strong> where internet access is restricted.<\/li>\n\n\n\n
          • Example: Deliver a set of images to a secure environment without using Docker Hub.<\/li>\n<\/ul>\n\n\n\n
            4. Disaster Recovery<\/strong><\/h3>\n\n\n\n
              \n
            • Load previously saved images as part of a disaster recovery plan<\/strong>.<\/li>\n<\/ul>\n\n\n\n
              5. CI\/CD Pipelines<\/strong><\/h3>\n\n\n\n
                \n
              • Use docker load<\/code> in CI\/CD pipelines to preload images on build agents.<\/li>\n\n\n\n
              • Example: Preload common base images to speed up builds.<\/li>\n<\/ul>\n\n\n\n
                6. Sharing Custom Images<\/strong><\/h3>\n\n\n\n
                  \n
                • Share custom-built images with teams or clients by sending the image tarball.<\/li>\n<\/ul>\n\n\n\n
                  \n\n\n\n
                  List of Common docker load<\/code> Commands<\/strong><\/h2>\n\n\n\n
                  Command<\/strong><\/th>Description<\/strong><\/th><\/tr><\/thead>
                  docker load -i my_image.tar<\/code><\/td>Load a Docker image from a tar file<\/td><\/tr>
                  `cat my_image.tar<\/td>docker load`<\/td><\/tr>
                  `gunzip < my_image.tar.gz<\/td>docker load`<\/td><\/tr>
                  docker load --input backup.tar<\/code><\/td>Load an image using the --input<\/code> option<\/td><\/tr>
                  docker load -i multiple_images.tar<\/code><\/td>Load multiple images from a tarball<\/td><\/tr>
                  docker load -i image.tar --quiet<\/code><\/td>Load an image without verbose output<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
                  \n\n\n\n
                  Best Practices for Using docker load<\/code>:<\/strong><\/h2>\n\n\n\n
                    \n
                  1. Verify the image tarball<\/strong> before loading it to ensure it was created properly (docker save<\/code>).<\/li>\n\n\n\n
                  2. Compress tarballs<\/strong> with gzip<\/code> or xz<\/code> to reduce file size for easier transfer.<\/li>\n\n\n\n
                  3. Use meaningful filenames<\/strong> (e.g., my_app_backup_20260207.tar<\/code>) for better organization.<\/li>\n\n\n\n
                  4. Automate image loading<\/strong> in scripts to streamline CI\/CD processes.<\/li>\n\n\n\n
                  5. Check the loaded image<\/strong> with docker images<\/code> to confirm successful import.<\/li>\n<\/ol>\n\n\n\n
                    \n\n\n\n
                    Common Errors and Solutions<\/strong><\/h2>\n\n\n\n
                      \n
                    1. “No such file or directory”<\/strong>
                      \u2192 Ensure the tarball exists and the file path is correct.<\/li>\n\n\n\n
                    2. “Invalid tar file”<\/strong>
                      \u2192 Verify that the tarball was created with docker save<\/code> and is not corrupted.<\/li>\n\n\n\n
                    3. “Image not found after loading”<\/strong>
                      \u2192 Check the output of docker load<\/code> to ensure the image was loaded with the expected tag.<\/li>\n\n\n\n
                    4. “Permission denied”<\/strong>
                      \u2192 Run the command with sudo<\/code> or check file permissions.<\/li>\n<\/ol>\n\n\n\n
                      \n\n\n\n
                      Combining docker load<\/code> with Other Commands<\/strong><\/h2>\n\n\n\n
                      Backup and Restore Workflow<\/strong><\/h3>\n\n\n\n
                        \n
                      1. Save the image:<\/strong> docker save -o my_image.tar my_image:latest<\/code><\/li>\n\n\n\n
                      2. Transfer and load the image:<\/strong> docker load -i my_image.tar<\/code><\/li>\n<\/ol>\n\n\n\n
                        \n\n\n\n
                        Verify the Loaded Image<\/strong><\/h3>\n\n\n
                        docker images | grep my_image\n<\/code><\/span><\/pre>\n\n\n
                        \n\n\n\n
                        Automate Image Loading in a CI\/CD Pipeline<\/strong><\/h3>\n\n\n
                        steps<\/span>:\n  -<\/span> name<\/span>: Load<\/span> Prebuilt<\/span> Docker<\/span> Image<\/span>\n    run<\/span>: docker<\/span> load<\/span> -i<\/span> my_prebuilt_image<\/span>.tar<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
                        \n\n\n\n
                        <\/p>\n","protected":false},"excerpt":{"rendered":"
                        Here\u2019s a complete tutorial on docker load, covering what it does, examples, and use cases. What is docker load? docker load is a Docker command used to load a Docker… <\/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-48445","post","type-post","status-publish","format-standard","hentry","category-docker"],"_links":{"self":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/48445","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=48445"}],"version-history":[{"count":3,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/48445\/revisions"}],"predecessor-version":[{"id":58892,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/48445\/revisions\/58892"}],"wp:attachment":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media?parent=48445"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/categories?post=48445"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/tags?post=48445"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}