docker image save

Estimated reading time: 2 minutes

Description

Save one or more images to a tar archive (streamed to STDOUT by default)

Usage

docker image save [OPTIONS] IMAGE [IMAGE...]

Options

Name, shorthand Default Description
--output, -o   Write to a file, instead of STDOUT

Parent command

Command Description
docker image Manage images
Command Description
docker image build Build an image from a Dockerfile
docker image history Show the history of an image
docker image import Import the contents from a tarball to create a filesystem image
docker image inspect Display detailed information on one or more images
docker image load Load an image from a tar archive or STDIN
docker image ls List images
docker image prune Remove unused images
docker image pull Pull an image or a repository from a registry
docker image push Push an image or a repository to a registry
docker image rm Remove one or more images
docker image save Save one or more images to a tar archive (streamed to STDOUT by default)
docker image tag Create a tag TARGET_IMAGE that refers to SOURCE_IMAGE

Extended 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.

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
chat icon Feedback? Suggestions? Can't find something in the docs?
Edit this page ● Request docs changes ● Get support
Rate this page: