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

DESCRIPTION

14       podman import imports a tarball (.tar, .tar.gz, .tgz, .bzip, .tar.xz,
15       .txz) and saves it as a filesystem image. Remote tarballs can be
16       specified using a URL.  Various image instructions can be configured
17       with the --change flag and a commit message can be set using the
18       --message flag.  reference, if present, is a tag to assign to the
19       image.  Note: : is a restricted character and cannot be part of the
20       file name.
21
22

OPTIONS

24       --change, -c
25
26
27       Apply the following possible instructions to the created image: CMD |
28       ENTRYPOINT | ENV | EXPOSE | LABEL | STOPSIGNAL | USER | VOLUME |
29       WORKDIR Can be set multiple times
30
31
32       --message, -m
33
34
35       Set commit message for imported image
36
37
38       --quiet, -q
39
40
41       Shows progress on the import
42
43
44       -verbose
45
46
47       Print additional debugging information
48
49
50       --help, -h
51
52
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              $ cat ctr.tar | podman -q import --message "importing the ctr.tar tarball" - image-imported
70              db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
71
72
73
74              $ cat ctr.tar | podman import -
75              Getting image source signatures
76              Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86
77               25.80 MB / 25.80 MB [======================================================] 0s
78              Copying config sha256:d61387b4d5edf65edee5353e2340783703074ffeaaac529cde97a8357eea7645
79               378 B / 378 B [============================================================] 0s
80              Writing manifest to image destination
81              Storing signatures
82              db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
83
84
85
86              $ podman import http://example.com/ctr.tar url-image
87              Downloading from "http://example.com/ctr.tar"
88              Getting image source signatures
89              Copying blob sha256:b41deda5a2feb1f03a5c1bb38c598cbc12c9ccd675f438edc6acd815f7585b86
90               25.80 MB / 25.80 MB [======================================================] 0s
91              Copying config sha256:5813fe8a3b18696089fd09957a12e88bda43dc1745b5240879ffffe93240d29a
92               419 B / 419 B [============================================================] 0s
93              Writing manifest to image destination
94              Storing signatures
95              db65d991f3bbf7f31ed1064db9a6ced7652e3f8166c4736aa9133dadd3c7acb3
96
97
98

SEE ALSO

100       podman(1), podman-export(1)
101
102

HISTORY

104       November 2017, Originally compiled by Urvashi Mohnani
105       ⟨umohnani@redhat.com⟩
106
107
108
109                                                              podman-import(1)