1podman-import(1)            General Commands Manual           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   --arch
30       Set architecture of the imported image.
31
32
33   --change, -c=instruction
34       Apply  the  following possible instructions to the created image: CMD |
35       ENTRYPOINT | ENV | EXPOSE | LABEL  |  STOPSIGNAL  |  USER  |  VOLUME  |
36       WORKDIR
37
38
39       Can be set multiple times
40
41
42   --help, -h
43       Print usage statement
44
45
46   --message, -m=message
47       Set commit message for imported image
48
49
50   --os
51       Set OS of the imported image.
52
53
54   --quiet, -q
55       Shows progress on the import
56
57
58   --variant
59       Set variant of the imported image.
60
61

EXAMPLES

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

SEE ALSO

126       podman(1), podman-export(1)
127
128

HISTORY

130       November  2017,  Originally  compiled  by Urvashi Mohnani umohnani@red‐
131       hat.com ⟨mailto:umohnani@redhat.com⟩
132
133
134
135                                                              podman-import(1)
Impressum