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

     1  % podman-import(1)
     2  
     3  ## NAME
     4  podman\-import - Import a tarball and save it as a filesystem image
     5  
     6  ## SYNOPSIS
     7  **podman import** [*options*] *path* [*reference*]
     8  
     9  **podman image import** [*options*] *path* [*reference*]
    10  
    11  ## DESCRIPTION
    12  **podman import** imports a tarball (.tar, .tar.gz, .tgz, .bzip, .tar.xz, .txz)
    13  and saves it as a filesystem image. Remote tarballs can be specified using a URL.
    14  Various image instructions can be configured with the **--change** flag and
    15  a commit message can be set using the **--message** flag.
    16  **reference**, if present, is a tag to assign to the image.
    17  **podman import** is used for importing from the archive generated by **podman export**, that includes the container's filesystem. To import the archive of image layers created by **podman save**, use **podman load**.
    18  Note: `:` is a restricted character and cannot be part of the file name.
    19  
    20  ## OPTIONS
    21  
    22  #### **--change**=*instruction*, **-c**
    23  
    24  Apply the following possible instructions to the created image:
    25  **CMD** | **ENTRYPOINT** | **ENV** | **EXPOSE** | **LABEL** | **STOPSIGNAL** | **USER** | **VOLUME** | **WORKDIR**
    26  
    27  Can be set multiple times
    28  
    29  #### **--message**, **-m**=*message*
    30  
    31  Set commit message for imported image
    32  
    33  #### **--quiet**, **-q**
    34  
    35  Shows progress on the import
    36  
    37  **-verbose**
    38  
    39  Print additional debugging information
    40  
    41  #### **--help**, **-h**
    42  
    43  Print usage statement
    44  
    45  ## EXAMPLES
    46  
    47  ```
    48  $ podman import --change CMD=/bin/bash --change ENTRYPOINT=/bin/sh --change LABEL=blue=image ctr.tar image-imported
    49  Getting image source signatures
    50  Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86
    51   25.80 MB / 25.80 MB [======================================================] 0s
    52  Copying config sha256:c16a6d30f3782288ec4e7521c754acc29d37155629cb39149756f486dae2d4cd
    53   448 B / 448 B [============================================================] 0s
    54  Writing manifest to image destination
    55  Storing signatures
    56  db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
    57  ```
    58  
    59  ```
    60  $ podman import --change 'ENTRYPOINT ["/bin/sh","-c","test-image"]'  --change LABEL=blue=image test-image.tar image-imported
    61  Getting image source signatures
    62  Copying blob e3b0c44298fc skipped: already exists
    63  Copying config 1105523502 done
    64  Writing manifest to image destination
    65  Storing signatures
    66  110552350206337183ceadc0bdd646dc356e06514c548b69a8917b4182414b
    67  ```
    68  ```
    69  $ podman import --change "CMD /bin/sh"  --change LABEL=blue=image test-image.tar image-imported
    70  Getting image source signatures
    71  Copying blob e3b0c44298fc skipped: already exists
    72  Copying config ae9a27e249 done
    73  Writing manifest to image destination
    74  Storing signatures
    75  ae9a27e249f801aff11a4ba54a81751ea9fbc9db45a6df3f1bfd63fc2437bb9c
    76  ```
    77  
    78  
    79  ```
    80  $ cat ctr.tar | podman -q import --message "importing the ctr.tar tarball" - image-imported
    81  db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
    82  ```
    83  
    84  ```
    85  $ cat ctr.tar | podman import -
    86  Getting image source signatures
    87  Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86
    88   25.80 MB / 25.80 MB [======================================================] 0s
    89  Copying config sha256:d61387b4d5edf65edee5353e2340783703074ffeaaac529cde97a8357eea7645
    90   378 B / 378 B [============================================================] 0s
    91  Writing manifest to image destination
    92  Storing signatures
    93  db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
    94  ```
    95  
    96  ```
    97  $ podman import http://example.com/ctr.tar url-image
    98  Downloading from "http://example.com/ctr.tar"
    99  Getting image source signatures
   100  Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86
   101   25.80 MB / 25.80 MB [======================================================] 0s
   102  Copying config sha256:5813fe8a3b18696089fd09957a12e88bda43dc1745b5240879ffffe93240d29a
   103   419 B / 419 B [============================================================] 0s
   104  Writing manifest to image destination
   105  Storing signatures
   106  db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
   107  ```
   108  
   109  ## SEE ALSO
   110  podman(1), podman-export(1)
   111  
   112  ## HISTORY
   113  November 2017, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>