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 will save parent layers of the image(s) and the  image(s)  can  be
21       loaded using podman load.  To export the containers, use the podman ex‐
22       port.  Note: : is a restricted character and cannot be part of the file
23       name.
24
25
26       podman [GLOBAL OPTIONS]
27
28
29       podman save [GLOBAL OPTIONS]
30
31
32       podman save [OPTIONS] NAME[:TAG]
33
34

OPTIONS

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

EXAMPLES

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

SEE ALSO

126       podman(1), podman-load(1), containers.conf(5), containers-transports(5)
127
128

HISTORY

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