2016-10-14 18:30:36 -04:00
|
|
|
---
|
|
|
|
title: "export"
|
|
|
|
description: "The export command description and usage"
|
2016-11-03 18:48:30 -04:00
|
|
|
keywords: "export, file, system, container"
|
2016-10-14 18:30:36 -04:00
|
|
|
---
|
2015-06-21 16:41:38 -04:00
|
|
|
|
|
|
|
# export
|
|
|
|
|
2016-07-07 14:43:18 -04:00
|
|
|
```markdown
|
|
|
|
Usage: docker export [OPTIONS] CONTAINER
|
2015-06-21 16:41:38 -04:00
|
|
|
|
2016-07-07 14:43:18 -04:00
|
|
|
Export a container's filesystem as a tar archive
|
2015-06-21 16:41:38 -04:00
|
|
|
|
2016-07-07 14:43:18 -04:00
|
|
|
Options:
|
|
|
|
--help Print usage
|
|
|
|
-o, --output string Write to a file, instead of STDOUT
|
|
|
|
```
|
2015-06-21 16:41:38 -04:00
|
|
|
|
2017-02-07 18:42:48 -05:00
|
|
|
## Description
|
|
|
|
|
2015-06-21 16:41:38 -04:00
|
|
|
The `docker export` command does not export the contents of volumes associated
|
|
|
|
with the container. If a volume is mounted on top of an existing directory in
|
|
|
|
the container, `docker export` will export the contents of the *underlying*
|
|
|
|
directory, not the contents of the volume.
|
|
|
|
|
2023-01-06 11:26:24 -05:00
|
|
|
Refer to [Backup, restore, or migrate data volumes](https://docs.docker.com/storage/volumes/#back-up-restore-or-migrate-data-volumes)
|
2017-02-07 18:42:48 -05:00
|
|
|
in the user guide for examples on exporting data in a volume.
|
2015-10-03 11:56:41 -04:00
|
|
|
|
|
|
|
## Examples
|
|
|
|
|
2017-02-07 18:42:48 -05:00
|
|
|
Each of these commands has the same result.
|
2015-10-03 11:56:41 -04:00
|
|
|
|
2021-08-21 08:54:14 -04:00
|
|
|
```console
|
2017-02-07 18:42:48 -05:00
|
|
|
$ docker export red_panda > latest.tar
|
|
|
|
```
|
2015-10-03 11:56:41 -04:00
|
|
|
|
2021-08-21 08:54:14 -04:00
|
|
|
```console
|
2017-02-07 18:42:48 -05:00
|
|
|
$ docker export --output="latest.tar" red_panda
|
|
|
|
```
|