docker-image-save - Man Page
Save one or more images to a tar archive (streamed to STDOUT by default)
Examples (TL;DR)
- Save an image by redirecting
stdoutto a.tararchive:docker [save|image save] image:tag > path/to/file.tar - Save an image to a
.tararchive:docker [save|image save] [-o|--output] path/to/file.tar image:tag - Save all tags of the image:
docker [save|image save] [-o|--output] path/to/file.tar image_name - Cherry-pick particular tags of an image to save:
docker [save|image save] [-o|--output] path/to/file.tar image_name:tag1 image_name:tag2 ...
Synopsis
docker image save [Options] IMAGE [IMAGE...]
Description
Produces a tarred repository to the standard output stream. Contains all parent layers, and all tags + versions, or specified repo:tag.
Stream to a file instead of STDOUT by using -o.
Examples
Save all fedora repository images to a fedora-all.tar and save the latest fedora image to a fedora-latest.tar:
$ docker image save fedora > fedora-all.tar $ docker image save --output=fedora-latest.tar fedora:latest $ ls -sh fedora-all.tar 721M fedora-all.tar $ ls -sh fedora-latest.tar 367M fedora-latest.tar
See also
docker-image-load(1) to load an image from a tar archive on STDIN.
Options
-o, --output="" Write to a file, instead of STDOUT
--platform=[] Save only the given platform(s). Formatted as a comma-separated list of "os[/arch[/variant]]" (e.g., "linux/amd64,linux/arm64/v8")
See Also
Referenced By
docker-image(1), docker-image-load(1).
Feb 2026 Docker Community Docker User Manuals