.nh
.TH podman\-save(1)
.SH NAME
.PP
podman\-save \- Save image(s) to an archive

.SH SYNOPSIS
.PP
\fBpodman save\fP [\fIoptions\fP] \fIname\fP[:\fItag\fP]

.PP
\fBpodman image save\fP [\fIoptions\fP] \fIname\fP[:\fItag\fP]

.SH DESCRIPTION
.PP
\fBpodman save\fP saves an image to either \fBdocker\-archive\fP, \fBoci\-archive\fP, \fBoci\-dir\fP (directory with oci manifest type), or \fBdocker\-dir\fP (directory with v2s2 manifest type) on the local machine,
default is \fBdocker\-archive\fP\&. \fBpodman save\fP writes to STDOUT by default and can be redirected to a
file using the \fBoutput\fP flag. The \fBquiet\fP flag suppresses the output when set.
\fBpodman save\fP will save parent layers of the image(s) and the image(s) can be loaded using \fBpodman load\fP\&.
To export the containers, use the \fBpodman export\fP\&.
Note: \fB\fC:\fR is a restricted character and cannot be part of the file name.

.PP
\fBpodman [GLOBAL OPTIONS]\fP

.PP
\fBpodman save [GLOBAL OPTIONS]\fP

.PP
\fBpodman save [OPTIONS] NAME[:TAG]\fP

.SH OPTIONS
.SS \fB\-\-compress\fP
.PP
Compress tarball image layers when pushing to a directory using the 'dir' transport. (default is same compression type, compressed or uncompressed, as source)
Note: This flag can only be set when using the \fBdir\fP transport i.e \-\-format=oci\-dir or \-\-format\-docker\-dir

.SS \fB\-\-output\fP, \fB\-o\fP=\fIfile\fP
.PP
Write to a file, default is STDOUT

.SS \fB\-\-format\fP=\fIformat\fP
.PP
Save image to \fBoci\-archive, oci\-dir\fP (directory with oci manifest type), or \fBdocker\-dir\fP (directory with v2s2 manifest type)

.PP
.RS

.nf
\-\-format oci\-archive
\-\-format oci\-dir
\-\-format docker\-dir

.fi
.RE

.SS \fB\-\-multi\-image\-archive\fP, \fB\-m\fP
.PP
Allow for creating archives with more than one image.  Additional names will be interpreted as images instead of tags.  Only supported for \fBdocker\-archive\fP\&.

.SS \fB\-\-quiet\fP, \fB\-q\fP
.PP
Suppress the output

.SS \fB\-\-help\fP, \fB\-h\fP
.PP
Print usage statement

.SH EXAMPLES
.PP
.RS

.nf
$ podman save \-\-quiet \-o alpine.tar alpine:2.6

.fi
.RE

.PP
.RS

.nf
$ podman save > alpine\-all.tar alpine

.fi
.RE

.PP
.RS

.nf
$ podman save \-o oci\-alpine.tar \-\-format oci\-archive alpine

.fi
.RE

.PP
.RS

.nf
$ podman save \-\-compress \-\-format oci\-dir \-o alp\-dir alpine
Getting image source signatures
Copying blob sha256:2fdfe1cd78c20d05774f0919be19bc1a3e4729bce219968e4188e7e0f1af679d
 1.97 MB / 1.97 MB [========================================================] 0s
Copying config sha256:501d1a8f0487e93128df34ea349795bc324d5e0c0d5112e08386a9dfaff620be
 584 B / 584 B [============================================================] 0s
Writing manifest to image destination
Storing signatures

.fi
.RE

.PP
.RS

.nf
$ podman save \-\-format docker\-dir \-o ubuntu\-dir ubuntu
Getting image source signatures
Copying blob sha256:660c48dd555dcbfdfe19c80a30f557ac57a15f595250e67bfad1e5663c1725bb
 45.55 MB / 45.55 MB [======================================================] 8s
Copying blob sha256:4c7380416e7816a5ab1f840482c9c3ca8de58c6f3ee7f95e55ad299abbfe599f
 846 B / 846 B [============================================================] 0s
Copying blob sha256:421e436b5f80d876128b74139531693be9b4e59e4f1081c9a3c379c95094e375
 620 B / 620 B [============================================================] 0s
Copying blob sha256:e4ce6c3651b3a090bb43688f512f687ea6e3e533132bcbc4a83fb97e7046cea3
 849 B / 849 B [============================================================] 0s
Copying blob sha256:be588e74bd348ce48bb7161350f4b9d783c331f37a853a80b0b4abc0a33c569e
 169 B / 169 B [============================================================] 0s
Copying config sha256:20c44cd7596ff4807aef84273c99588d22749e2a7e15a7545ac96347baa65eda
 3.53 KB / 3.53 KB [========================================================] 0s
Writing manifest to image destination
Storing signatures

.fi
.RE

.SH SEE ALSO
.PP
podman(1), podman\-load(1)

.SH HISTORY
.PP
July 2017, Originally compiled by Urvashi Mohnani umohnani@redhat.com
\[la]mailto:umohnani@redhat.com\[ra]