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>
| ... | ... |
@@ -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 |