github.com/containers/podman/v5@v5.1.0-rc1/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  #### **--arch**
    23  
    24  Set architecture of the imported image.
    25  
    26  #### **--change**, **-c**=*instruction*
    27  
    28  Apply the following possible instructions to the created image:
    29  **CMD** | **ENTRYPOINT** | **ENV** | **EXPOSE** | **LABEL** | **STOPSIGNAL** | **USER** | **VOLUME** | **WORKDIR**
    30  
    31  Can be set multiple times
    32  
    33  #### **--help**, **-h**
    34  
    35  Print usage statement
    36  
    37  #### **--message**, **-m**=*message*
    38  
    39  Set commit message for imported image
    40  
    41  #### **--os**
    42  
    43  Set OS of the imported image.
    44  
    45  #### **--quiet**, **-q**
    46  
    47  Shows progress on the import
    48  
    49  #### **--variant**
    50  
    51  Set variant of the imported image.
    52  
    53  ## EXAMPLES
    54  
    55  Import the selected tarball into new image, specifying the CMD, ENTRYPOINT and LABEL:
    56  ```
    57  $ podman import --change CMD=/bin/bash --change ENTRYPOINT=/bin/sh --change LABEL=blue=image ctr.tar image-imported
    58  Getting image source signatures
    59  Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86
    60   25.80 MB / 25.80 MB [======================================================] 0s
    61  Copying config sha256:c16a6d30f3782288ec4e7521c754acc29d37155629cb39149756f486dae2d4cd
    62   448 B / 448 B [============================================================] 0s
    63  Writing manifest to image destination
    64  Storing signatures
    65  db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
    66  ```
    67  
    68  Import the selected tarball into new image, specifying the CMD, ENTRYPOINT and LABEL:
    69  ```
    70  $ podman import --change 'ENTRYPOINT ["/bin/sh","-c","test-image"]'  --change LABEL=blue=image test-image.tar image-imported
    71  Getting image source signatures
    72  Copying blob e3b0c44298fc skipped: already exists
    73  Copying config 1105523502 done
    74  Writing manifest to image destination
    75  Storing signatures
    76  110552350206337183ceadc0bdd646dc356e06514c548b69a8917b4182414b
    77  ```
    78  
    79  Import new tagged image from stdin in quiet mode:
    80  ```
    81  $ cat ctr.tar | podman -q import --message "importing the ctr.tar file" - image-imported
    82  db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
    83  ```
    84  
    85  Import an image from stdin:
    86  ```
    87  $ cat ctr.tar | podman import -
    88  Getting image source signatures
    89  Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86
    90   25.80 MB / 25.80 MB [======================================================] 0s
    91  Copying config sha256:d61387b4d5edf65edee5353e2340783703074ffeaaac529cde97a8357eea7645
    92   378 B / 378 B [============================================================] 0s
    93  Writing manifest to image destination
    94  Storing signatures
    95  db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
    96  ```
    97  
    98  Import named image from tarball via a URL:
    99  ```
   100  $ podman import http://example.com/ctr.tar url-image
   101  Downloading from "http://example.com/ctr.tar"
   102  Getting image source signatures
   103  Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86
   104   25.80 MB / 25.80 MB [======================================================] 0s
   105  Copying config sha256:5813fe8a3b18696089fd09957a12e88bda43dc1745b5240879ffffe93240d29a
   106   419 B / 419 B [============================================================] 0s
   107  Writing manifest to image destination
   108  Storing signatures
   109  db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
   110  ```
   111  
   112  ## SEE ALSO
   113  **[podman(1)](podman.1.md)**, **[podman-export(1)](podman-export.1.md)**
   114  
   115  ## HISTORY
   116  November 2017, Originally compiled by Urvashi Mohnani <umohnani@redhat.com>