Browse code

Docs: Add note that export doesn't include volume data.

The documentation on `docker export` doesn't mention that
data in volumes is not included in the export.

This adds a note that volumes are not part of the export
and refers to the "Backup, restore, or migrate data volumes"
to give the user some pointers.

Relates to https://github.com/docker/docker/issues/10095

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>

Sebastiaan van Stijn authored on 2015/01/15 07:47:17
Showing 1 changed files
... ...
@@ -998,6 +998,15 @@ For example:
998 998
 
999 999
     $ sudo docker export red_panda > latest.tar
1000 1000
 
1001
+> **Note:**
1002
+> `docker export` does not export the contents of volumes associated with the
1003
+> container. If a volume is mounted on top of an existing directory in the 
1004
+> container, `docker export` will export the contents of the *underlying* 
1005
+> directory, not the contents of the volume.
1006
+>
1007
+> Refer to [Backup, restore, or migrate data volumes](/userguide/dockervolumes/#backup-restore-or-migrate-data-volumes)
1008
+> in the user guide for examples on exporting data in a volume.
1009
+
1001 1010
 ## history
1002 1011
 
1003 1012
     Usage: docker history [OPTIONS] IMAGE