1podman-import(1)()                                          podman-import(1)()
2
3
4

NAME

6       podman-import - Import a tarball and save it as a filesystem image
7
8

SYNOPSIS

10       podman import [options] path [reference]
11
12
13       podman image import [options] path [reference]
14
15

DESCRIPTION

17       podman  import  imports a tarball (.tar, .tar.gz, .tgz, .bzip, .tar.xz,
18       .txz) and saves it as a filesystem image. Remote tarballs can be speci‐
19       fied  using  a  URL.  Various image instructions can be configured with
20       the --change flag and a commit message can be set using  the  --message
21       flag.   reference, if present, is a tag to assign to the image.  podman
22       import is used for importing from the archive generated by  podman  ex‐
23       port,  that  includes the container's filesystem. To import the archive
24       of image layers created by podman save, use podman load.  Note: : is  a
25       restricted character and cannot be part of the file name.
26
27

OPTIONS

29   --change=instruction, -c
30       Apply  the  following possible instructions to the created image: CMD |
31       ENTRYPOINT | ENV | EXPOSE | LABEL  |  STOPSIGNAL  |  USER  |  VOLUME  |
32       WORKDIR
33
34
35       Can be set multiple times
36
37
38   --message, -m=message
39       Set commit message for imported image
40
41
42   --quiet, -q
43       Shows progress on the import
44
45
46       --verbose
47
48
49       Print additional debugging information
50
51
52   --help, -h
53       Print usage statement
54
55

EXAMPLES

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
69              $ podman import --change 'ENTRYPOINT ["/bin/sh","-c","test-image"]'  --change LABEL=blue=image test-image.tar image-imported
70              Getting image source signatures
71              Copying blob e3b0c44298fc skipped: already exists
72              Copying config 1105523502 done
73              Writing manifest to image destination
74              Storing signatures
75              110552350206337183ceadc0bdd646dc356e06514c548b69a8917b4182414b
76
77
78
79              $ podman import --change "CMD /bin/sh"  --change LABEL=blue=image test-image.tar image-imported
80              Getting image source signatures
81              Copying blob e3b0c44298fc skipped: already exists
82              Copying config ae9a27e249 done
83              Writing manifest to image destination
84              Storing signatures
85              ae9a27e249f801aff11a4ba54a81751ea9fbc9db45a6df3f1bfd63fc2437bb9c
86
87
88
89              $ cat ctr.tar | podman -q import --message "importing the ctr.tar tarball" - image-imported
90              db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
91
92
93
94              $ cat ctr.tar | podman import -
95              Getting image source signatures
96              Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86
97               25.80 MB / 25.80 MB [======================================================] 0s
98              Copying config sha256:d61387b4d5edf65edee5353e2340783703074ffeaaac529cde97a8357eea7645
99               378 B / 378 B [============================================================] 0s
100              Writing manifest to image destination
101              Storing signatures
102              db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
103
104
105
106              $ podman import http://example.com/ctr.tar url-image
107              Downloading from "http://example.com/ctr.tar"
108              Getting image source signatures
109              Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86
110               25.80 MB / 25.80 MB [======================================================] 0s
111              Copying config sha256:5813fe8a3b18696089fd09957a12e88bda43dc1745b5240879ffffe93240d29a
112               419 B / 419 B [============================================================] 0s
113              Writing manifest to image destination
114              Storing signatures
115              db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
116
117
118

SEE ALSO

120       podman(1), podman-export(1)
121
122

HISTORY

124       November  2017,  Originally  compiled  by Urvashi Mohnani umohnani@red‐
125       hat.com ⟨mailto:umohnani@redhat.com⟩
126
127
128
129                                                            podman-import(1)()
Impressum