github.com/containers/podman/v2@v2.2.2-0.20210501105131-c1e07d070c4c/docs/source/markdown/podman-load.1.md (about)

     1  % podman-load(1)
     2  
     3  ## NAME
     4  podman\-load - Load image(s) from a tar archive into container storage
     5  
     6  ## SYNOPSIS
     7  **podman load** [*options*] [*name*[:*tag*]]
     8  
     9  **podman image load** [*options*] [*name*[:*tag*]]
    10  
    11  ## DESCRIPTION
    12  **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.
    13  You can also specify a name for the image if the archive does not contain a named reference, of if you want an additional name for the local image.
    14  **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**.
    15  
    16  The local client further supports loading an **oci-dir** or a **docker-dir** as created with **podman save** (1).
    17  
    18  The **quiet** option suppresses the progress output when set.
    19  Note: `:` is a restricted character and cannot be part of the file name.
    20  
    21  
    22  **podman [GLOBAL OPTIONS]**
    23  
    24  **podman load [GLOBAL OPTIONS]**
    25  
    26  **podman load [OPTIONS] NAME[:TAG]**
    27  
    28  ## OPTIONS
    29  
    30  #### **--input**, **-i**=*input*
    31  
    32  Read from archive file, default is STDIN.
    33  
    34  The remote client requires the use of this option.
    35  
    36  NOTE: Use the environment variable `TMPDIR` to change the temporary storage location of container images. Podman defaults to use `/var/tmp`.
    37  
    38  #### **--quiet**, **-q**
    39  
    40  Suppress the progress output
    41  
    42  #### **--help**, **-h**
    43  
    44  Print usage statement
    45  
    46  ## EXAMPLES
    47  
    48  ```
    49  $ podman load --quiet -i fedora.tar
    50  ```
    51  
    52  ```
    53  $ podman load -q -i fedora.tar
    54  ```
    55  
    56  ```
    57  $ podman load < fedora.tar
    58  Getting image source signatures
    59  Copying blob sha256:5bef08742407efd622d243692b79ba0055383bbce12900324f75e56f589aedb0
    60   0 B / 4.03 MB [---------------------------------------------------------------]
    61  Copying config sha256:7328f6f8b41890597575cbaadc884e7386ae0acc53b747401ebce5cf0d624560
    62   0 B / 1.48 KB [---------------------------------------------------------------]
    63  Writing manifest to image destination
    64  Storing signatures
    65  Loaded image:  registry.fedoraproject.org/fedora:latest
    66  ```
    67  
    68  ```
    69  $ cat fedora.tar | podman load
    70  Getting image source signatures
    71  Copying blob sha256:5bef08742407efd622d243692b79ba0055383bbce12900324f75e56f589aedb0
    72   0 B / 4.03 MB [---------------------------------------------------------------]
    73  Copying config sha256:7328f6f8b41890597575cbaadc884e7386ae0acc53b747401ebce5cf0d624560
    74   0 B / 1.48 KB [---------------------------------------------------------------]
    75  Writing manifest to image destination
    76  Storing signatures
    77  Loaded image:  registry.fedoraproject.org/fedora:latest
    78  ```
    79  
    80  ## SEE ALSO
    81  podman(1), podman-save(1), podman-tag(1)
    82  
    83  ## HISTORY
    84  July 2017, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>