.nh
.TH podman-load 1
.SH NAME
podman-load \- Load image(s) from tar archives, directories, or URLs into container storage

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

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

.SH DESCRIPTION
\fBpodman load\fP loads a saved image(s) into local container storage from tar archives, directories, or URLs pointing to an tar archive. By default, \fBpodman load\fP reads from stdin, to load from any of the other input sources use the \fB--input\fR option.

.PP
\fBpodman load\fP operates on \fIimages\fP: it restores an archive created by \fBpodman save\fP as the same image, preserving its layers, history and tags. This is different from \fBpodman import\fP, which builds a \fInew\fP image from a root-filesystem tarball (such as one produced by \fBpodman export\fP) with no image history. To import a container's filesystem instead, see \fBpodman-import(1)\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.

.PP
Note: \fB:\fR is a restricted character and cannot be part of the file name.

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

.SS \fB--input\fP, \fB-i\fP=\fIinput\fP
Load the specified input file or URL instead of reading from stdin. The input can be one of:
.IP \(bu 2
A local tar archive (uncompressed or compressed)
.IP \(bu 2
A local OCI or Docker directory layout
.IP \(bu 2
A URL to a tar archive (not available on macOS and Windows)

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

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

.SH EXAMPLES
Create an image from a compressed tar file, without showing progress.

.EX
$ podman load --quiet -i fedora.tar.gz
.EE

.PP
Create an image from the archive.tar file pulled from a URL, without showing progress.

.EX
$ podman load -q -i https://server.com/archive.tar
.EE

.PP
Create an image from a directory created with either podman-save \fB--format oci-dir\fR or \fB--format docker-dir\fR

.EX
$ podman load -i fedora/
.EE

.PP
Create an image from stdin using bash redirection from a tar file.

.EX
$ 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
.EE

.PP
Create an image from stdin using a pipe.

.EX
$ 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
.EE

.SH SEE ALSO
\fBpodman(1)\fP, \fBpodman-save(1)\fP

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