2018-08-30 08:41:19 +00:00
% podman-load(1)
2017-11-01 15:24:59 +00:00
## NAME
2019-03-16 10:46:35 +00:00
podman\-load - Load an image from a container image archive into container storage
2017-11-01 15:24:59 +00:00
## SYNOPSIS
2019-03-16 10:46:35 +00:00
**podman load** [*name*[:*tag*]]
2017-11-01 15:24:59 +00:00
## DESCRIPTION
2019-03-16 10:46:35 +00:00
**podman load** loads an image from either an **oci-archive** or **docker-archive** stored on the local machine into container storage. **podman load** reads from stdin by default or a file if the **input** option is set.
You can also specify a name for the image if the archive does not contain a named reference, of if you want an additonal name for the local image.
The **quiet** option suppresses the progress output when set.
2018-04-29 21:37:51 +00:00
Note: `:` is a restricted character and cannot be part of the file name.
2017-11-01 15:24:59 +00:00
2019-03-16 10:46:35 +00:00
2017-12-15 21:58:36 +00:00
**podman [GLOBAL OPTIONS]**
2017-11-01 15:24:59 +00:00
2017-12-15 21:58:36 +00:00
**podman load [GLOBAL OPTIONS]**
2017-11-01 15:24:59 +00:00
2019-03-16 10:46:35 +00:00
**podman load [OPTIONS] NAME[:TAG]**
2017-11-01 15:24:59 +00:00
## OPTIONS
**--input, -i**
2018-06-14 15:44:39 +00:00
2019-02-21 23:09:59 +00:00
Read from archive file, default is STDIN.
The remote client requires the use of this option.
2017-11-01 15:24:59 +00:00
**--quiet, -q**
2018-06-14 15:44:39 +00:00
2019-03-16 10:46:35 +00:00
Suppress the progress output
2017-11-01 15:24:59 +00:00
**--signature-policy="PATHNAME"**
Pathname of a signature policy file to use. It is not recommended that this
option be used, as the default behavior of using the system-wide default policy
(frequently */etc/containers/policy.json* ) is most often preferred
2018-06-29 17:53:33 +00:00
**--help**, ** -h**
Print usage statement
2017-11-01 15:24:59 +00:00
## EXAMPLES
```
2018-08-30 11:05:37 +00:00
$ podman load --quiet -i fedora.tar
2017-11-01 15:24:59 +00:00
```
```
2018-08-30 11:05:37 +00:00
$ podman load -q --signature-policy /etc/containers/policy.json -i fedora.tar
2017-11-01 15:24:59 +00:00
```
```
2018-08-30 11:05:37 +00:00
$ podman load < fedora.tar
2017-11-01 15:24:59 +00:00
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
2017-12-06 19:09:51 +00:00
Loaded image: registry.fedoraproject.org/fedora:latest
2017-11-01 15:24:59 +00:00
```
```
2018-08-30 11:05:37 +00:00
$ cat fedora.tar | podman load
2017-11-01 15:24:59 +00:00
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
2017-12-06 19:09:51 +00:00
Loaded image: registry.fedoraproject.org/fedora:latest
2017-11-01 15:24:59 +00:00
```
## SEE ALSO
2019-04-13 10:29:00 +00:00
podman(1), podman-save(1), podman-tag(1)
2017-11-01 15:24:59 +00:00
## HISTORY
July 2017, Originally compiled by Urvashi Mohnani < umohnani @ redhat . com >