docker export: Export a Container Filesystem
Flatten a container filesystem to a single tar - no layers, no history.
docker export serializes a container filesystem (not an image) to a tar archive. It pairs with docker import. This page covers when to use it versus docker save.
What it does
docker export writes the current filesystem of a container as a flat tar. It drops layer history, image metadata, ENTRYPOINT/CMD, and environment - those live in image config, not the filesystem.
Common usage
Terminal
docker export -o rootfs.tar mycontainer
docker export mycontainer | gzip > rootfs.tar.gz
docker create --name tmp myapp:latest && docker export -o fs.tar tmpCommon errors in CI
A frequent surprise: an image built from docker export | docker import "loses" its CMD/ENTRYPOINT and starts nothing, because export discards image config. If you need a runnable image with metadata, use docker save/load instead. export needs a container ID, not an image name - create one first with docker create.
Frequently asked questions
docker export: Export a Container Filesystem?
docker export serializes a container filesystem (not an image) to a tar archive. It pairs with docker import. This page covers when to use it versus docker save.
What it does?
docker export writes the current filesystem of a container as a flat tar. It drops layer history, image metadata, ENTRYPOINT/CMD, and environment - those live in image config, not the filesystem.
Common errors in CI?
A frequent surprise: an image built from docker export | docker import "loses" its CMD/ENTRYPOINT and starts nothing, because export discards image config. If you need a runnable image with metadata, use docker save/load instead. export needs a container ID, not an image name - create one first with docker create.
Related guides
docker import: Create an Image from a TarballHow docker import works: building a single-layer image from a filesystem tar, setting CMD on import, and the
docker save: Export Images to a Tar ArchiveHow docker save works: serializing one or more images to a tar archive with layers and metadata, for caching
docker load: Import Images from a Tar ArchiveHow docker load works: restoring images saved with docker save, loading from stdin or a file, and CI
docker commit: Create an Image from a ContainerHow docker commit works: snapshotting a container into a new image, setting CMD, and why Dockerfiles beat