1podman-save(1)              General Commands Manual             podman-save(1)
2
3
4

NAME

6       podman-save - Save image(s) to an archive
7
8

SYNOPSIS

10       podman save [options] name[:tag]
11
12
13       podman image save [options] name[:tag]
14
15

DESCRIPTION

17       podman  save  saves an image to a local file or directory.  podman save
18       writes to STDOUT by default and can be redirected to a file  using  the
19       output  flag.  The  quiet  flag suppresses the output when set.  podman
20       save saves parent layers of the image(s) and the image(s) can be loaded
21       using  podman  load.   To export the containers, use the podman export.
22       Note: : is a restricted character and cannot be part of the file name.
23
24
25       podman [GLOBAL OPTIONS]
26
27
28       podman save [GLOBAL OPTIONS]
29
30
31       podman save [OPTIONS] NAME[:TAG]
32
33

OPTIONS

35   --compress
36       Compress tarball image layers when pushing to  a  directory  using  the
37       'dir'  transport.  (default is same compression type, compressed or un‐
38       compressed, as source)
39
40
41       Note: This flag can only be set with --format=docker-dir.
42
43
44   --format=format
45       An image format to produce, one of:
46
47
48       ┌───────────────┬──────────────────────────────────────────────────────────────────────┐
49       │Format         │ Description                                                          │
50       ├───────────────┼──────────────────────────────────────────────────────────────────────┤
51       │docker-archive │ A tar archive interoperable with docker load(1) (the default)        │
52       ├───────────────┼──────────────────────────────────────────────────────────────────────┤
53       │oci-archive    │ A tar archive using the OCI Image Format                             │
54       ├───────────────┼──────────────────────────────────────────────────────────────────────┤
55       │oci-dir        │ A directory using the OCI Image Format                               │
56       ├───────────────┼──────────────────────────────────────────────────────────────────────┤
57       │docker-dir     │ dir transport (see containers-transports(5)) with v2s2 manifest type │
58       └───────────────┴──────────────────────────────────────────────────────────────────────┘
59
60   --help, -h
61       Print usage statement
62
63
64   --multi-image-archive, -m
65       Allow for creating archives with more than one image.  Additional names
66       are  interpreted  as images instead of tags.  Only supported for --for‐
67       mat=docker-archive.  The default for this option can  be  modified  via
68       the multi_image_archive="true"|"false" flag in containers.conf.
69
70
71   --output, -o=file
72       Write to a file, default is STDOUT
73
74
75   --quiet, -q
76       Suppress the output
77
78
79   --uncompressed
80       Accept uncompressed layers when using one of the OCI formats.
81
82

EXAMPLES

84       $ podman save --quiet -o alpine.tar alpine:2.6
85
86
87       $ podman save > alpine-all.tar alpine
88
89
90       $ podman save -o oci-alpine.tar --format oci-archive alpine
91
92
93       $ podman save --compress --format oci-dir -o alp-dir alpine
94       Getting image source signatures
95       Copying blob sha256:2fdfe1cd78c20d05774f0919be19bc1a3e4729bce219968e4188e7e0f1af679d
96        1.97 MB / 1.97 MB [========================================================] 0s
97       Copying config sha256:501d1a8f0487e93128df34ea349795bc324d5e0c0d5112e08386a9dfaff620be
98        584 B / 584 B [============================================================] 0s
99       Writing manifest to image destination
100       Storing signatures
101
102
103       $ podman save --format docker-dir -o ubuntu-dir ubuntu
104       Getting image source signatures
105       Copying blob sha256:660c48dd555dcbfdfe19c80a30f557ac57a15f595250e67bfad1e5663c1725bb
106        45.55 MB / 45.55 MB [======================================================] 8s
107       Copying blob sha256:4c7380416e7816a5ab1f840482c9c3ca8de58c6f3ee7f95e55ad299abbfe599f
108        846 B / 846 B [============================================================] 0s
109       Copying blob sha256:421e436b5f80d876128b74139531693be9b4e59e4f1081c9a3c379c95094e375
110        620 B / 620 B [============================================================] 0s
111       Copying blob sha256:e4ce6c3651b3a090bb43688f512f687ea6e3e533132bcbc4a83fb97e7046cea3
112        849 B / 849 B [============================================================] 0s
113       Copying blob sha256:be588e74bd348ce48bb7161350f4b9d783c331f37a853a80b0b4abc0a33c569e
114        169 B / 169 B [============================================================] 0s
115       Copying config sha256:20c44cd7596ff4807aef84273c99588d22749e2a7e15a7545ac96347baa65eda
116        3.53 KB / 3.53 KB [========================================================] 0s
117       Writing manifest to image destination
118       Storing signatures
119
120
121

SEE ALSO

123       podman(1), podman-load(1), containers.conf(5), containers-transports(5)
124
125

HISTORY

127       July  2017,  Originally compiled by Urvashi Mohnani umohnani@redhat.com
128       ⟨mailto:umohnani@redhat.com⟩
129
130
131
132                                                                podman-save(1)