mirror of
https://github.com/podman-container-tools/podman.git
synced 2026-08-14 04:39:33 +00:00
9cb516acb0
The four man pages cross-reference each other but never say how the two workflows actually differ, which keeps confusing users. save/load work on images and keep layers, history and tags; export/import work on a container's filesystem, flattened into a single-layer tarball with no history (import then builds a new image from it). Add a short, matching note to each of the four pages pointing at the complementary command. Kept to that distinction, nothing about pulling from a registry. Fixes: #22155 Signed-off-by: Grzegorz Szczepanczyk <g.szczepanczyk@getprintbox.com>
53 lines
1.6 KiB
Markdown
53 lines
1.6 KiB
Markdown
% podman-export 1
|
|
|
|
## NAME
|
|
podman\-export - Export a container's filesystem contents as a tar archive
|
|
|
|
## SYNOPSIS
|
|
**podman export** [*options*] *container*
|
|
|
|
**podman container export** [*options*] *container*
|
|
|
|
## DESCRIPTION
|
|
**podman export** exports the filesystem of a container and saves it as a tarball
|
|
on the local machine. **podman export** writes to STDOUT by default and can be
|
|
redirected to a file using the `--output` flag.
|
|
The image of the container exported by **podman export** can be imported by **podman import**.
|
|
To export image(s) with parent layers, use **podman save**.
|
|
Note: `:` is a restricted character and cannot be part of the file name.
|
|
|
|
**podman export** operates on a *container's* filesystem: it flattens the filesystem into a single-layer tarball with no image layers, history or tags. This is different from **podman save**, which archives an *image* and preserves its layers, history and tags. To archive an image instead, see **podman-save(1)**.
|
|
|
|
**podman [GLOBAL OPTIONS]**
|
|
|
|
**podman export [GLOBAL OPTIONS]**
|
|
|
|
**podman export [OPTIONS] CONTAINER**
|
|
|
|
## OPTIONS
|
|
|
|
#### **--help**, **-h**
|
|
|
|
Print usage statement
|
|
|
|
#### **--output**, **-o**
|
|
|
|
Write to a file, default is STDOUT
|
|
|
|
## EXAMPLES
|
|
|
|
Export container into specified tar ball:
|
|
```
|
|
$ podman export -o redis-container.tar 883504668ec465463bc0fe7e63d53154ac3b696ea8d7b233748918664ea90e57
|
|
```
|
|
|
|
Export container to stdout:
|
|
```
|
|
$ podman export 883504668ec465463bc0fe7e63d53154ac3b696ea8d7b233748918664ea90e57 > redis-container.tar
|
|
```
|
|
|
|
## SEE ALSO
|
|
**[podman(1)](podman.1.md)**, **[podman-import(1)](podman-import.1.md)**
|
|
|
|
## HISTORY
|
|
August 2017, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>
|