man/docker-export.1.md
0a0dd116
 % DOCKER(1) Docker User Manuals
b07f1938
 % Docker Community
 % JUNE 2014
0a0dd116
 # NAME
f38232b4
 docker-export - Export the contents of a container's filesystem as a tar archive
0a0dd116
 
 # SYNOPSIS
b07f1938
 **docker export**
a2b529ea
 [**--help**]
d79860af
 [**-o**|**--output**[=*""*]]
b07f1938
 CONTAINER
0a0dd116
 
 # DESCRIPTION
 Export the contents of a container's filesystem using the full or shortened
 container ID or container name. The output is exported to STDOUT and can be
 redirected to a tar file.
 
5ff122f7
 Stream to a file instead of STDOUT by using **-o**.
 
b07f1938
 # OPTIONS
a2b529ea
 **--help**
   Print usage statement
d79860af
   
5ff122f7
 **-o**, **--output**=""
d79860af
   Write to a file, instead of STDOUT
b07f1938
 
 # EXAMPLES
0a0dd116
 Export the contents of the container called angry_bell to a tar file
5ff122f7
 called angry_bell.tar:
0a0dd116
 
5ff122f7
     # docker export angry_bell > angry_bell.tar
     # docker export --output=angry_bell-latest.tar angry_bell
     # ls -sh angry_bell.tar
     321M angry_bell.tar
     # ls -sh angry_bell-latest.tar
     321M angry_bell-latest.tar
0a0dd116
 
cbb149f5
 # See also
 **docker-import(1)** to create an empty filesystem image
 and import the contents of the tarball into it, then optionally tag it.
 
0a0dd116
 # HISTORY
 April 2014, Originally compiled by William Henry (whenry at redhat dot com)
fa29b1f0
 based on docker.com source material and internal work.
b07f1938
 June 2014, updated by Sven Dowideit <SvenDowideit@home.org.au>
3d87b80b
 January 2015, updated by Joseph Kern (josephakern at gmail dot com)