1podman-pull(1)() podman-pull(1)()
2
3
4
6 podman-pull - Pull an image from a registry
7
8
10 podman pull [options] name[:tag|@digest]
11
12
13 podman image pull [options] name[:tag|@digest]
14
15
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
28 Image stored in local container/storage
29
30
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
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
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
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
202 podman(1), podman-push(1), podman-login(1), containers-reg‐
203 istries.conf(5)
204
205
207 July 2017, Originally compiled by Urvashi Mohnani umohnani@redhat.com
208 ⟨mailto:umohnani@redhat.com⟩
209
210
211
212 podman-pull(1)()