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

SEE ALSO

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

HISTORY

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