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

NAME

6       podman-pull - Pull an image from a registry
7
8

SYNOPSIS

10       podman pull [options] name[:tag|@digest]
11
12
13       podman image pull [options] name[:tag|@digest]
14
15

DESCRIPTION

17       Copies  an  image  from  a registry onto the local machine. podman pull
18       pulls an image from Docker Hub if a registry is not  specified  in  the
19       command  line  argument.  If an image tag is not specified, podman pull
20       defaults to the image with the latest tag (if it exists) and pulls  it.
21       After the image is pulled, podman will print the full image ID.  podman
22       pull can also pull an image using its digest podman pull  image@digest.
23       podman  pull can be used to pull images from archives and local storage
24       using different transports.
25
26

imageID

28       Image stored in local container/storage
29
30

SOURCE

32       The SOURCE is a location to get container images
33        The Image "SOURCE" uses a "transport":"details" format.
34
35
36       Multiple transports are supported:
37
38
39       dir:path
40         An existing local directory path storing the manifest, layer tarballs
41       and  signatures as individual files. This is a non-standardized format,
42       primarily useful for debugging or noninvasive container inspection.
43
44
45       docker://docker-reference
46         An image in a registry implementing the  "Docker  Registry  HTTP  API
47       V2".  By default, uses the authorization state in $XDG_RUNTIME_DIR/con‐
48       tainers/auth.json, which is set using (podman login). If the authoriza‐
49       tion  state  is  not found there, $HOME/.docker/config.json is checked,
50       which is set using (docker login).
51
52
53       docker-archive:path[:docker-reference]
54         An image is stored in the docker save formatted file.   docker-refer‐
55       ence  is only used when creating such a file, and it must not contain a
56       digest.
57
58
59       docker-daemon:docker-reference
60         An image docker-reference stored in the docker daemon internal  stor‐
61       age.  docker-reference must contain either a tag or a digest.  Alterna‐
62       tively, when  reading  images,  the  format  can  also  be  docker-dae‐
63       mon:algo:digest (an image ID).
64
65
66       oci-archive:path:tag
67         An image tag in a directory compliant with "Open Container Image Lay‐
68       out Specification" at path.
69
70
71       ostree:image[@/absolute/repo/path]
72         An image in local OSTree repository.  /absolute/repo/path defaults to
73       /ostree/repo.
74
75

OPTIONS

77       --all-tags, a
78
79
80       All tagged images in the repository will be pulled.
81
82
83       Note:  When  using  the all-tags flag, Podman will not iterate over the
84       search registries in the containers-registries.conf(5) but will  always
85       use docker.io for unqualified image names.
86
87
88       --authfile=path
89
90
91       Path of the authentication file. Default is ${XDG_RUNTIME_DIR}/contain‐
92       ers/auth.json, which is set using podman login.  If  the  authorization
93       state  is  not found there, $HOME/.docker/config.json is checked, which
94       is set using docker login. (Not available for remote commands)
95
96
97       Note: You can also override the default path of the authentication file
98       by  setting  the  REGISTRY_AUTH_FILE  environment variable. export REG‐
99       ISTRY_AUTH_FILE=path
100
101
102       --cert-dir=path
103
104
105       Use certificates at path (*.crt, *.cert, *.key) to connect to the  reg‐
106       istry.  Default certificates directory is /etc/containers/certs.d. (Not
107       available for remote commands)
108
109
110       --creds=[username[:password]]
111
112
113       The [username[:password]] to use to authenticate with the  registry  if
114       required.   If  one  or  both  values  are not supplied, a command line
115       prompt will appear and the value  can  be  entered.   The  password  is
116       entered without echo.
117
118
119       --quiet, -q
120
121
122       Suppress output information when pulling images
123
124
125       --tls-verify=true|false
126
127
128       Require  HTTPS  and  verify  certificates  when  contacting  registries
129       (default: true). If explicitly set to true, then TLS verification  will
130       be  used.  If  set to false, then TLS verification will not be used. If
131       not specified, TLS verification will be used unless the target registry
132       is  listed  as  an insecure registry in registries.conf. (Not available
133       for remote commands)
134
135
136       --help, -h
137
138
139       Print usage statement
140
141

EXAMPLES

143              $ podman pull alpine:latest
144              Trying to pull registry.access.redhat.com/alpine:latest... Failed
145              Trying to pull registry.fedoraproject.org/alpine:latest... Failed
146              Trying to pull docker.io/library/alpine:latest...Getting image source signatures
147              Copying blob sha256:88286f41530e93dffd4b964e1db22ce4939fffa4a4c665dab8591fbab03d4926
148               1.90 MB / 1.90 MB [========================================================] 0s
149              Copying config sha256:76da55c8019d7a47c347c0dceb7a6591144d232a7dd616242a367b8bed18ecbc
150               1.48 KB / 1.48 KB [========================================================] 0s
151              Writing manifest to image destination
152              Storing signatures
153              04660052281190168dbb2362eb15bf7067a8dc642d2498055e0e72efa961a4b6
154
155
156
157              $ podman pull --authfile temp-auths/myauths.json docker://docker.io/umohnani/finaltest
158              Trying to pull docker.io/umohnani/finaltest:latest...Getting image source signatures
159              Copying blob sha256:6d987f6f42797d81a318c40d442369ba3dc124883a0964d40b0c8f4f7561d913
160               1.90 MB / 1.90 MB [========================================================] 0s
161              Copying config sha256:ad4686094d8f0186ec8249fc4917b71faa2c1030d7b5a025c29f26e19d95c156
162               1.41 KB / 1.41 KB [========================================================] 0s
163              Writing manifest to image destination
164              Storing signatures
165              03290064078cb797f3e0a530e78c20c13dd22a3dd3adf84a5da2127b48df0438
166
167
168
169              $ podman pull --creds testuser:testpassword docker.io/umohnani/finaltest
170              Trying to pull docker.io/umohnani/finaltest:latest...Getting image source signatures
171              Copying blob sha256:6d987f6f42797d81a318c40d442369ba3dc124883a0964d40b0c8f4f7561d913
172               1.90 MB / 1.90 MB [========================================================] 0s
173              Copying config sha256:ad4686094d8f0186ec8249fc4917b71faa2c1030d7b5a025c29f26e19d95c156
174               1.41 KB / 1.41 KB [========================================================] 0s
175              Writing manifest to image destination
176              Storing signatures
177              03290064078cb797f3e0a530e78c20c13dd22a3dd3adf84a5da2127b48df0438
178
179
180
181              $ podman pull --tls-verify=false --cert-dir image/certs docker.io/umohnani/finaltest
182              Trying to pull docker.io/umohnani/finaltest:latest...Getting image source signatures
183              Copying blob sha256:6d987f6f42797d81a318c40d442369ba3dc124883a0964d40b0c8f4f7561d913
184               1.90 MB / 1.90 MB [========================================================] 0s
185              Copying config sha256:ad4686094d8f0186ec8249fc4917b71faa2c1030d7b5a025c29f26e19d95c156
186               1.41 KB / 1.41 KB [========================================================] 0s
187              Writing manifest to image destination
188              Storing signatures
189              03290064078cb797f3e0a530e78c20c13dd22a3dd3adf84a5da2127b48df0438
190
191
192

FILES

194       registries.conf (/etc/containers/registries.conf)
195
196
197              registries.conf is the configuration file which specifies which container registries should be consulted when completing image names which do not include a registry or domain portion.
198
199
200

SEE ALSO

202       podman(1),     podman-push(1),     podman-login(1),     containers-reg‐
203       istries.conf(5)
204
205

HISTORY

207       July  2017,  Originally compiled by Urvashi Mohnani umohnani@redhat.com
208       ⟨mailto:umohnani@redhat.com⟩
209
210
211
212                                                              podman-pull(1)()
Impressum