% DOCKER(1) Docker User Manuals % Docker Community % JUNE 2014

NAME

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

SYNOPSIS

docker save [--help] [-o|--output[=OUTPUT]] 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.

OPTIONS

--help Print usage statement

-o, --output="" Write to a file, instead of STDOUT

EXAMPLES

Save all fedora repository images to a fedora-all.tar and save the latest fedora image to a fedora-latest.tar:

$ docker save fedora > fedora-all.tar
$ docker 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-load(1) to load an image from a tar archive on STDIN.

HISTORY

April 2014, Originally compiled by William Henry (whenry at redhat dot com) based on docker.com source material and internal work. June 2014, updated by Sven Dowideit SvenDowideit@home.org.au November 2014, updated by Sven Dowideit SvenDowideit@home.org.au