summaryrefslogtreecommitdiff
path: root/docs/man/docker-save.1.md
diff options
context:
space:
mode:
Diffstat (limited to 'docs/man/docker-save.1.md')
-rw-r--r--docs/man/docker-save.1.md37
1 files changed, 37 insertions, 0 deletions
diff --git a/docs/man/docker-save.1.md b/docs/man/docker-save.1.md
new file mode 100644
index 0000000000..533b4c8435
--- /dev/null
+++ b/docs/man/docker-save.1.md
@@ -0,0 +1,37 @@
+% DOCKER(1) Docker User Manuals
+% Docker Community
+% JUNE 2014
+# NAME
+docker-save - Save an image to a tar archive (streamed to STDOUT by default)
+
+# SYNOPSIS
+**docker save**
+[**-o**|**--output**[=*OUTPUT*]]
+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
+**-o**, **--output**=""
+ Write to an 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:
+
+ $ sudo docker save fedora > fedora-all.tar
+ $ sudo 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
+
+# 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>