github.com/dpiddy/docker@v1.12.2-rc1/man/docker-save.1.md (about)

     1  % DOCKER(1) Docker User Manuals
     2  % Docker Community
     3  % JUNE 2014
     4  # NAME
     5  docker-save - Save one or more images to a tar archive (streamed to STDOUT by default)
     6  
     7  # SYNOPSIS
     8  **docker save**
     9  [**--help**]
    10  [**-o**|**--output**[=*OUTPUT*]]
    11  IMAGE [IMAGE...]
    12  
    13  # DESCRIPTION
    14  Produces a tarred repository to the standard output stream. Contains all
    15  parent layers, and all tags + versions, or specified repo:tag.
    16  
    17  Stream to a file instead of STDOUT by using **-o**.
    18  
    19  # OPTIONS
    20  **--help**
    21    Print usage statement
    22  
    23  **-o**, **--output**=""
    24     Write to a file, instead of STDOUT
    25  
    26  # EXAMPLES
    27  
    28  Save all fedora repository images to a fedora-all.tar and save the latest
    29  fedora image to a fedora-latest.tar:
    30  
    31      $ docker save fedora > fedora-all.tar
    32      $ docker save --output=fedora-latest.tar fedora:latest
    33      $ ls -sh fedora-all.tar
    34      721M fedora-all.tar
    35      $ ls -sh fedora-latest.tar
    36      367M fedora-latest.tar
    37  
    38  # See also
    39  **docker-load(1)** to load an image from a tar archive on STDIN.
    40  
    41  # HISTORY
    42  April 2014, Originally compiled by William Henry (whenry at redhat dot com)
    43  based on docker.com source material and internal work.
    44  June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>
    45  November 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>