.nh
.TH podman\-load(1)
.SH NAME
.PP
podman\-load \- Load image(s) from a tar archive into container storage

.SH SYNOPSIS
.PP
\fBpodman load\fP [\fIoptions\fP]

.PP
\fBpodman image load\fP [\fIoptions\fP]

.SH DESCRIPTION
.PP
\fBpodman load\fP loads an image from either an \fBoci\-archive\fP or a \fBdocker\-archive\fP stored on the local machine into container storage. \fBpodman load\fP reads from stdin by default or a file if the \fBinput\fP option is set.
\fBpodman load\fP is used for loading from the archive generated by \fBpodman save\fP, that includes the image parent layers. To load the archive of container's filesystem created by \fBpodman export\fP, use \fBpodman import\fP\&.

.PP
The local client further supports loading an \fBoci\-dir\fP or a \fBdocker\-dir\fP as created with \fBpodman save\fP (1).

.PP
The \fBquiet\fP option suppresses the progress output when set.
Note: \fB\fC:\fR is a restricted character and cannot be part of the file name.

.PP
\fBpodman [GLOBAL OPTIONS]\fP

.PP
\fBpodman load [GLOBAL OPTIONS]\fP

.PP
\fBpodman load [OPTIONS]\fP

.SH OPTIONS
.SS \fB\-\-input\fP, \fB\-i\fP=\fIinput\fP
.PP
Read from archive file, default is STDIN.

.PP
The remote client requires the use of this option.

.PP
NOTE: Use the environment variable \fB\fCTMPDIR\fR to change the temporary storage location of container images. Podman defaults to use \fB\fC/var/tmp\fR\&.

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

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

.SH EXAMPLES
.PP
.RS

.nf
$ podman load \-\-quiet \-i fedora.tar

.fi
.RE

.PP
.RS

.nf
$ podman load \-q \-i fedora.tar

.fi
.RE

.PP
.RS

.nf
$ podman load < fedora.tar
Getting image source signatures
Copying blob sha256:5bef08742407efd622d243692b79ba0055383bbce12900324f75e56f589aedb0
 0 B / 4.03 MB [\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-]
Copying config sha256:7328f6f8b41890597575cbaadc884e7386ae0acc53b747401ebce5cf0d624560
 0 B / 1.48 KB [\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-]
Writing manifest to image destination
Storing signatures
Loaded image:  registry.fedoraproject.org/fedora:latest

.fi
.RE

.PP
.RS

.nf
$ cat fedora.tar | podman load
Getting image source signatures
Copying blob sha256:5bef08742407efd622d243692b79ba0055383bbce12900324f75e56f589aedb0
 0 B / 4.03 MB [\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-]
Copying config sha256:7328f6f8b41890597575cbaadc884e7386ae0acc53b747401ebce5cf0d624560
 0 B / 1.48 KB [\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-]
Writing manifest to image destination
Storing signatures
Loaded image:  registry.fedoraproject.org/fedora:latest

.fi
.RE

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

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