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

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

\n\n\n\n

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

docker export<\/code> is a Docker command used to export the filesystem of a container<\/strong> as a tarball. This allows you to save the container’s data as a single file, which can then be imported or extracted later.<\/p>\n\n\n\n

Key Features:<\/strong><\/h3>\n\n\n\n
    \n
  • Exports the filesystem<\/strong> of a container, excluding image layers and Docker metadata.<\/li>\n\n\n\n
  • Useful for creating backups<\/strong> or transferring containers to other systems.<\/li>\n\n\n\n
  • Does not preserve container configuration (e.g., environment variables, ports).<\/li>\n<\/ul>\n\n\n\n
    \n\n\n\n

    Basic Syntax<\/strong><\/h2>\n\n\n
    docker export<\/span> [OPTIONS] CONTAINER\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
    Options:<\/strong><\/h3>\n\n\n\n
      \n
    • -o<\/code>, --output<\/code>: Write the output to a file instead of standard output.<\/li>\n<\/ul>\n\n\n\n
      \n\n\n\n
      Examples of docker export<\/code><\/strong><\/h2>\n\n\n\n
      1. Export a Container\u2019s Filesystem to a Tar File<\/strong><\/h3>\n\n\n
      docker export<\/span> -o my_container.tar my_container\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      This saves the filesystem of my_container<\/code> as a tarball named my_container.tar<\/code>.<\/p>\n\n\n\n
      \n\n\n\n
      2. Export a Container and Pipe it to Another Command<\/strong><\/h3>\n\n\n
      docker export<\/span> my_container | gzip > my_container.tar.gz\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      This compresses the exported filesystem of my_container<\/code> and saves it as my_container.tar.gz<\/code>.<\/p>\n\n\n\n
      \n\n\n\n
      3. Extract Files from the Exported Tarball<\/strong><\/h3>\n\n\n\n
      Export the container:<\/p>\n\n\n
      docker export<\/span> -o my_container.tar my_container\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      Extract the tarball contents:<\/p>\n\n\n
      tar -xvf my_container.tar -C \/path\/to\/extract\n<\/code><\/span><\/pre>\n\n\n
      \n\n\n\n
      4. Export and Transfer the Container to Another Machine<\/strong><\/h3>\n\n\n\n
      Export the container:<\/p>\n\n\n
      docker export<\/span> -o my_container.tar my_container\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      Transfer the file to another machine (e.g., using scp<\/code>):<\/p>\n\n\n
      scp my_container.tar user@remote:\/path\/<\/span>to\/destination\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      \n\n\n\n
      5. Combine docker export<\/code> with docker import<\/code><\/strong><\/h3>\n\n\n\n
      Export the container:<\/p>\n\n\n
      docker export<\/span> -o my_container.tar my_container\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      Import the tarball as a new image:<\/p>\n\n\n
      docker<\/span> import<\/span> my_container<\/span>.tar<\/span> my_new_image<\/span>:latest<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      Run a container from the new image:<\/p>\n\n\n
      docker<\/span> run<\/span> -it<\/span> my_new_image<\/span>:latest<\/span> bash<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
      \n\n\n\n
      6. Export Multiple Containers Using a Script<\/strong><\/h3>\n\n\n
      #!\/bin\/bash<\/span>\nfor<\/span> container in<\/span> $(docker ps -q); do<\/span>\n  docker export<\/span> -o ${container}.tar $container\n  echo \"Exported $container\"<\/span>\ndone\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      This script exports the filesystems of all running containers to separate tar files.<\/p>\n\n\n\n
      \n\n\n\n
      7. Export a Stopped Container<\/strong><\/h3>\n\n\n\n
      You can export stopped containers as well:<\/p>\n\n\n
      docker export<\/span> -o stopped_container.tar stopped_container\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      \n\n\n\n
      8. Use docker export<\/code> with docker cp<\/code><\/strong><\/h3>\n\n\n\n
      Export the filesystem and extract only specific files:<\/p>\n\n\n
      docker export<\/span> my_container | tar -xvf - .\/path\/to\/file\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
      \n\n\n\n
      Use Cases for docker export<\/code><\/strong><\/h2>\n\n\n\n
      1. Backup and Restore<\/strong><\/h3>\n\n\n\n
        \n
      • Export the entire filesystem of a container for backup purposes.<\/li>\n\n\n\n
      • Example: Backup the filesystem of a database container for disaster recovery.<\/li>\n<\/ul>\n\n\n\n
        2. Transfer Containers Across Environments<\/strong><\/h3>\n\n\n\n
          \n
        • Use docker export<\/code> to transfer container filesystems to other environments or systems.<\/li>\n\n\n\n
        • Example: Export a container from a development machine and import it into a production system.<\/li>\n<\/ul>\n\n\n\n
          3. Debugging and Inspection<\/strong><\/h3>\n\n\n\n
            \n
          • Export the container filesystem to analyze or debug its contents.<\/li>\n\n\n\n
          • Example: Extract configuration files or logs for debugging purposes.<\/li>\n<\/ul>\n\n\n\n
            4. Reduce Image Size for Specific Use Cases<\/strong><\/h3>\n\n\n\n
              \n
            • Export a container, remove unnecessary files, and re-import it as a lighter image.<\/li>\n\n\n\n
            • Example: Create a minimal base image from a container.<\/li>\n<\/ul>\n\n\n\n
              5. Sharing Application State<\/strong><\/h3>\n\n\n\n
                \n
              • Export a container with pre-installed applications or dependencies for easy sharing.<\/li>\n<\/ul>\n\n\n\n
                \n\n\n\n
                List of Common docker export<\/code> Commands<\/strong><\/h2>\n\n\n\n
                Command<\/strong><\/th>Description<\/strong><\/th><\/tr><\/thead>
                docker export -o my_container.tar my_container<\/code><\/td>Export a container to a tar file<\/td><\/tr>
                `docker export my_container<\/td>gzip > my_container.tar.gz`<\/td><\/tr>
                `docker export my_container<\/td>tar -xvf – -C \/path`<\/td><\/tr>
                docker export -o stopped_container.tar stopped_container<\/code><\/td>Export a stopped container<\/td><\/tr>
                `docker export my_container<\/td>docker import – my_new_image`<\/td><\/tr>
                docker export -o \/backups\/db_backup.tar db_container<\/code><\/td>Backup a database container\u2019s filesystem<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
                \n\n\n\n
                Best Practices for Using docker export<\/code>:<\/strong><\/h2>\n\n\n\n
                  \n
                1. Combine with docker import<\/code><\/strong> to create portable images from exported containers.<\/li>\n\n\n\n
                2. Compress tarballs<\/strong> using tools like gzip<\/code> or xz<\/code> to save storage space.<\/li>\n\n\n\n
                3. Use meaningful filenames<\/strong> when exporting containers (e.g., include timestamps).<\/li>\n\n\n\n
                4. Verify exported tarballs<\/strong> by extracting them and inspecting the contents.<\/li>\n\n\n\n
                5. Exclude sensitive data<\/strong> from exported containers before sharing or transferring.<\/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 container”<\/strong>
                    \u2192 Ensure the container exists and is running\/stopped. Use docker ps -a<\/code> to verify.<\/li>\n\n\n\n
                  2. “Permission denied”<\/strong>
                    \u2192 Use elevated privileges (sudo<\/code>) or ensure the current user has Docker permissions.<\/li>\n\n\n\n
                  3. “File size too large”<\/strong>
                    \u2192 Compress the tarball during export (gzip<\/code> or xz<\/code>) or exclude unnecessary files before exporting.<\/li>\n\n\n\n
                  4. “Exported tarball is incomplete”<\/strong>
                    \u2192 Verify the container was running\/stopped properly before export.<\/li>\n<\/ol>\n\n\n\n
                    \n\n\n\n
                    Combining docker export<\/code> with Other Commands<\/strong><\/h2>\n\n\n\n
                    Backup and Restore a Container<\/strong><\/h3>\n\n\n\n
                    Export the container:<\/p>\n\n\n
                    docker export<\/span> -o db_backup.tar db_container\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
                    Transfer the tarball to another system and re-import it as an image:<\/p>\n\n\n
                    docker<\/span> import<\/span> db_backup<\/span>.tar<\/span> db_image<\/span>:latest<\/span>\ndocker<\/span> run<\/span> -it<\/span> db_image<\/span>:latest<\/span> bash<\/span>\n<\/code><\/span>Code language:<\/span> CSS<\/span> (<\/span>css<\/span>)<\/span><\/small><\/pre>\n\n\n
                    Extract Logs from an Exported Container<\/strong><\/h3>\n\n\n
                    docker export<\/span> my_container | tar -xvf - .\/var<\/span>\/log\n<\/code><\/span>Code language:<\/span> JavaScript<\/span> (<\/span>javascript<\/span>)<\/span><\/small><\/pre>\n\n\n
                    \n\n\n\n
                    <\/p>\n","protected":false},"excerpt":{"rendered":"
                    Here\u2019s a complete tutorial on docker export, covering what it does, examples, and use cases. What is docker export? docker export is a Docker command used to export the filesystem… <\/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-48428","post","type-post","status-publish","format-standard","hentry","category-docker"],"_links":{"self":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/48428","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=48428"}],"version-history":[{"count":3,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/48428\/revisions"}],"predecessor-version":[{"id":48431,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/48428\/revisions\/48431"}],"wp:attachment":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media?parent=48428"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/categories?post=48428"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/tags?post=48428"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}