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

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

\n\n\n\n

What are docker save<\/code> and docker load<\/code>?<\/strong><\/h2>\n\n\n\n
    \n
  • docker save<\/code><\/strong>: This command exports Docker images<\/strong> (with all layers, tags, and metadata) as a tarball file<\/strong>. You can then transfer or archive the image.<\/li>\n\n\n\n
  • docker load<\/code><\/strong>: This command restores images<\/strong> from a tarball created with docker save<\/code>.<\/li>\n<\/ul>\n\n\n\n

    Key Features:<\/strong><\/h3>\n\n\n\n
      \n
    • docker save<\/code>: Backup and transfer images<\/strong> without relying on a Docker registry.<\/li>\n\n\n\n
    • docker load<\/code>: Import images<\/strong> from tarballs on any machine.<\/li>\n\n\n\n
    • Supports compressed<\/strong> tarballs (.tar.gz<\/code>).<\/li>\n<\/ul>\n\n\n\n
      \n\n\n\n

      docker save<\/code> Command Syntax<\/strong><\/h2>\n\n\n
      docker<\/span> save<\/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
      • -o<\/code>, --output<\/code>: Write the tarball to a file instead of standard output.<\/li>\n<\/ul>\n\n\n\n
        \n\n\n\n
        Examples of docker save<\/code><\/strong><\/h2>\n\n\n\n
        1. Save a Single Image to a Tarball<\/strong><\/h3>\n\n\n
        docker<\/span> save<\/span> -o<\/span> my_image<\/span>.tar<\/span> my_image<\/span>:latest<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
        This saves the my_image:latest<\/code> to a tar file named my_image.tar<\/code>.<\/p>\n\n\n\n
        \n\n\n\n
        2. Save Multiple Images to a Single Tarball<\/strong><\/h3>\n\n\n
        docker<\/span> save<\/span> -o<\/span> images_backup<\/span>.tar<\/span> my_image<\/span>:latest<\/span> alpine<\/span>:3.14<\/span> nginx<\/span>:latest<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
        This saves multiple images (my_image<\/code>, alpine<\/code>, and nginx<\/code>) to a single tar file.<\/p>\n\n\n\n
        \n\n\n\n
        3. Save an Image and Compress It<\/strong><\/h3>\n\n\n
        docker save my_image:latest | gzip > my_image.tar.gz\n<\/code><\/span><\/pre>\n\n\n
        This saves the image and compresses it into my_image.tar.gz<\/code>.<\/p>\n\n\n\n
        \n\n\n\n
        4. Use docker save<\/code> with Standard Output<\/strong><\/h3>\n\n\n
        docker<\/span> save<\/span> my_image<\/span>:latest<\/span> > my_image<\/span>.tar<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
        This saves the image and writes the output to a tar file.<\/p>\n\n\n\n
        \n\n\n\n
        5. Save and Transfer an Image to Another System<\/strong><\/h3>\n\n\n
        docker save -o my_image.tar my_image:latest\nscp my_image.tar user@remote:\/path\/<\/span>to\/destination\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
        This saves the image to my_image.tar<\/code> and transfers it to a remote machine using scp<\/code>.<\/p>\n\n\n\n
        \n\n\n\n
        6. Automate Image Backup with a Script<\/strong><\/h3>\n\n\n
        #!\/bin\/bash<\/span>\ndocker save -o \/backups\/my_app_$(date +%Y%m%d).tar my_app:latest\necho \"Image backed up as my_app_$(date +%Y%m%d).tar\"<\/span>\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
        This script saves my_app:latest<\/code> with a timestamped filename.<\/p>\n\n\n\n
        \n\n\n\n
        7. Check the Content of a Saved Tarball<\/strong><\/h3>\n\n\n
        tar<\/span> -tvf<\/span> my_image<\/span>.tar<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
        This lists the contents of the tar file, showing layers and metadata.<\/p>\n\n\n\n
        \n\n\n\n
        docker load<\/code> Command 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>: Load from a file instead of standard input.<\/li>\n\n\n\n
        • --quiet<\/code>: Suppress verbose output during the 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 my_image.tar<\/code> into the local Docker repository.<\/p>\n\n\n\n
          \n\n\n\n
          2. Load 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.<\/p>\n\n\n\n
          \n\n\n\n
          3. Load an Image from Standard Input<\/strong><\/h3>\n\n\n
          cat my_image.tar | docker load\n<\/code><\/span><\/pre>\n\n\n
          This pipes the tar file 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> images_backup<\/span>.tar<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
          If images_backup.tar<\/code> contains multiple images, they will all be loaded into Docker.<\/p>\n\n\n\n
          \n\n\n\n
          5. Quietly Load an Image<\/strong><\/h3>\n\n\n
          docker<\/span> load<\/span> -i<\/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
          Suppresses verbose output while loading the image.<\/p>\n\n\n\n
          \n\n\n\n
          6. Automate Image Loading with a Script<\/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
          \n\n\n\n
          Use Cases for docker save<\/code> and docker load<\/code><\/strong><\/h2>\n\n\n\n
          1. Backup and Restore Images<\/strong><\/h3>\n\n\n\n
            \n
          • Backup images<\/strong> to tar files for disaster recovery.<\/li>\n\n\n\n
          • Restore images<\/strong> after a system upgrade or failure.<\/li>\n\n\n\n
          • Example: Save a production image and reload it on a fresh Docker host.<\/li>\n<\/ul>\n\n\n\n
            \n\n\n\n
            2. Transfer Images Between Systems<\/strong><\/h3>\n\n\n\n
              \n
            • Move images between development, staging, and production<\/strong> environments without pushing them to Docker Hub.<\/li>\n\n\n\n
            • Example: Transfer images to an air-gapped environment<\/strong>.<\/li>\n<\/ul>\n\n\n\n
              \n\n\n\n
              3. CI\/CD Pipelines<\/strong><\/h3>\n\n\n\n
                \n
              • Preload common images on build agents for faster builds.<\/li>\n\n\n\n
              • Example: Use docker save<\/code> to cache images and docker load<\/code> to reuse them in CI\/CD.<\/li>\n<\/ul>\n\n\n\n
                \n\n\n\n
                4. Air-Gapped Deployments<\/strong><\/h3>\n\n\n\n
                  \n
                • Use docker save<\/code> to transfer images into restricted environments<\/strong> without internet access.<\/li>\n\n\n\n
                • Example: Load images into an offline server.<\/li>\n<\/ul>\n\n\n\n
                  \n\n\n\n
                  5. Sharing Custom Images<\/strong><\/h3>\n\n\n\n
                    \n
                  • Share custom-built Docker images with clients or collaborators as tar files.<\/li>\n\n\n\n
                  • Example: Send a custom application image as my_app.tar.gz<\/code>.<\/li>\n<\/ul>\n\n\n\n
                    \n\n\n\n
                    6. Disaster Recovery and Migration<\/strong><\/h3>\n\n\n\n
                      \n
                    • Use docker save<\/code> to migrate images to a new host.<\/li>\n\n\n\n
                    • Example: Move legacy Docker images to a new infrastructure.<\/li>\n<\/ul>\n\n\n\n
                      \n\n\n\n
                      List of Common docker save<\/code> and docker load<\/code> Commands<\/strong><\/h2>\n\n\n\n
                      Command<\/strong><\/th>Description<\/strong><\/th><\/tr><\/thead>
                      docker save -o my_image.tar my_image:latest<\/code><\/td>Save an image to a tar file<\/td><\/tr>
                      `docker save my_image:latest<\/td>gzip > my_image.tar.gz`<\/td><\/tr>
                      docker save -o images_backup.tar nginx alpine<\/code><\/td>Save multiple images to a single tarball<\/td><\/tr>
                      docker load -i my_image.tar<\/code><\/td>Load an image from a tar file<\/td><\/tr>
                      `gunzip < my_image.tar.gz<\/td>docker load`<\/td><\/tr>
                      docker load < my_image.tar<\/code><\/td>Load an image using standard input<\/td><\/tr>
                      docker save -o backup.tar my_app:1.0<\/code><\/td>Save a specific image tag<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
                      \n\n\n\n
                      Best Practices for Using docker save<\/code> and docker load<\/code>:<\/strong><\/h2>\n\n\n\n
                        \n
                      1. Use meaningful filenames<\/strong> when saving images (e.g., my_app_backup_20260207.tar<\/code>).<\/li>\n\n\n\n
                      2. Compress large images<\/strong> with gzip<\/code> or xz<\/code> to reduce file size.<\/li>\n\n\n\n
                      3. Verify the loaded image<\/strong> with docker images<\/code> to ensure it imported successfully.<\/li>\n\n\n\n
                      4. Automate image backups<\/strong> in scripts for regular snapshots.<\/li>\n\n\n\n
                      5. Check tarball integrity<\/strong> before loading (tar -tvf my_image.tar<\/code>).<\/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 tar file exists and the path is correct.<\/li>\n\n\n\n
                        2. “Invalid tar file”<\/strong>
                          \u2192 Verify 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 confirm the image and tag.<\/li>\n\n\n\n
                        4. “Permission denied”<\/strong>
                          \u2192 Run the command with sudo<\/code> or check your user permissions.<\/li>\n<\/ol>\n\n\n\n
                          \n\n\n\n
                          Combining docker save<\/code> and docker load<\/code> in Workflows<\/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
                            Automate Backup and Restore<\/strong><\/h3>\n\n\n
                            #!\/bin\/bash<\/span>\n# Backup<\/span>\ndocker save -o \/backups\/my_app_backup.tar my_app:latest\n\n# Restore<\/span>\ndocker load -i \/backups\/my_app_backup.tar\n<\/code><\/span>Code language:<\/span> PHP<\/span> (<\/span>php<\/span>)<\/span><\/small><\/pre>\n\n\n
                            \n","protected":false},"excerpt":{"rendered":"
                            Here\u2019s a complete tutorial on docker save and docker load, covering what they do, examples, and use cases. What are docker save and docker load? Key Features: docker save Command… <\/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-48451","post","type-post","status-publish","format-standard","hentry","category-docker"],"_links":{"self":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/48451","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=48451"}],"version-history":[{"count":3,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/48451\/revisions"}],"predecessor-version":[{"id":58893,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/48451\/revisions\/58893"}],"wp:attachment":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media?parent=48451"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/categories?post=48451"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/tags?post=48451"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}