mirror of
https://github.com/containers/podman.git
synced 2025-10-25 18:25:59 +08:00
a6046dceef
Docker does not support this, and it is confusing what to do if the image has more then one tag. We are dropping support for this in podman 3.0 Fixes: https://github.com/containers/podman/issues/7387 Signed-off-by: Daniel J Walsh <dwalsh@redhat.com>
84 lines
2.6 KiB
Markdown
84 lines
2.6 KiB
Markdown
% podman-load(1)
|
|
|
|
## NAME
|
|
podman\-load - Load image(s) from a tar archive into container storage
|
|
|
|
## SYNOPSIS
|
|
**podman load** [*options*]
|
|
|
|
**podman image load** [*options*]
|
|
|
|
## DESCRIPTION
|
|
**podman load** loads an image from either an **oci-archive** or a **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.
|
|
**podman load** is used for loading from the archive generated by **podman save**, that includes the image parent layers. To load the archive of container's filesystem created by **podman export**, use **podman import**.
|
|
|
|
The local client further supports loading an **oci-dir** or a **docker-dir** as created with **podman save** (1).
|
|
|
|
The **quiet** option suppresses the progress output when set.
|
|
Note: `:` is a restricted character and cannot be part of the file name.
|
|
|
|
|
|
**podman [GLOBAL OPTIONS]**
|
|
|
|
**podman load [GLOBAL OPTIONS]**
|
|
|
|
**podman load [OPTIONS]**
|
|
|
|
## OPTIONS
|
|
|
|
#### **--input**, **-i**=*input*
|
|
|
|
Read from archive file, default is STDIN.
|
|
|
|
The remote client requires the use of this option.
|
|
|
|
NOTE: Use the environment variable `TMPDIR` to change the temporary storage location of container images. Podman defaults to use `/var/tmp`.
|
|
|
|
#### **--quiet**, **-q**
|
|
|
|
Suppress the progress output
|
|
|
|
#### **--help**, **-h**
|
|
|
|
Print usage statement
|
|
|
|
## EXAMPLES
|
|
|
|
```
|
|
$ podman load --quiet -i fedora.tar
|
|
```
|
|
|
|
```
|
|
$ podman load -q -i fedora.tar
|
|
```
|
|
|
|
```
|
|
$ 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
|
|
```
|
|
|
|
```
|
|
$ 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
|
|
```
|
|
|
|
## SEE ALSO
|
|
podman(1), podman-save(1)
|
|
|
|
## HISTORY
|
|
July 2017, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>
|