1podman-pull(1) General Commands Manual podman-pull(1)
2
6 podman-pull - Pull an image from a registry
7
10 podman pull [options] name[:tag|@digest]
11
14 Copies an image from a registry onto the local machine. podman pull
15 pulls an image from Docker Hub if a registry is not specified in the
16 command line argument. If an image tag is not specified, podman pull
17 defaults to the image with the latest tag (if it exists) and pulls it.
18 After the image is pulled, podman will print the full image ID. podman
19 pull can also pull an image using its digest podman pull image@digest.
20 podman pull can be used to pull images from archives and local storage
21 using different transports.
22
25 Image stored in local container/storage
26
29 The SOURCE is a location to get container images
30 The Image "SOURCE" uses a "transport":"details" format.
31 Multiple transports are supported:
34 dir:path
37 An existing local directory path storing the manifest, layer tarballs
38 and signatures as individual files. This is a non-standardized format,
39 primarily useful for debugging or noninvasive container inspection.
40 docker://docker-reference
43 An image in a registry implementing the "Docker Registry HTTP API
44 V2". By default, uses the authorization state in
45 $XDG_RUNTIME_DIR/containers/auth.json, which is set using (podman
46 login). If the authorization state is not found there,
47 $HOME/.docker/config.json is checked, which is set using (docker
48 login).
49 docker-archive:path[:docker-reference]
52 An image is stored in the docker save formatted file.
53 docker-reference is only used when creating such a file, and it must
54 not contain a digest.
55 docker-daemon:docker-reference
58 An image docker-reference stored in the docker daemon internal
59 storage. docker-reference must contain either a tag or a digest.
60 Alternatively, when reading images, the format can also be
61 docker-daemon:algo:digest (an image ID).
62 oci-archive:path:tag
65 An image tag in a directory compliant with "Open Container Image
66 Layout Specification" at path.
67 ostree:image[@/absolute/repo/path]
70 An image in local OSTree repository. /absolute/repo/path defaults to
71 /ostree/repo.
72
75 --all-tags, a
76 All tagged images in the repository will be pulled.
79 Note: When using the all-tags flag, Podman will not iterate over the
82 search registries in the containers-registries.conf(5) but will always
83 use docker.io for unqualified image names.
84 --authfile
87 Path of the authentication file. Default is
90 ${XDG_RUNTIME_DIR}/containers/auth.json, which is set using podman
91 login. If the authorization state is not found there,
92 $HOME/.docker/config.json is checked, which is set using docker login.
93 (Not available for remote commands)
94 Note: You can also override the default path of the authentication file
97 by setting the REGISTRY_AUTH_FILE environment variable. export
98 REGISTRY_AUTH_FILE=path
99 --cert-dir path
102 Use certificates at path (*.crt, *.cert, *.key) to connect to the
105 registry. Default certificates directory is /etc/containers/certs.d.
106 (Not available for remote commands)
107 --creds
110 The [username[:password]] to use to authenticate with the registry if
113 required. If one or both values are not supplied, a command line
114 prompt will appear and the value can be entered. The password is
115 entered without echo.
116 --quiet, -q
119 Suppress output information when pulling images
122 --tls-verify
125 Require HTTPS and verify certificates when contacting registries
128 (default: true). If explicitly set to true, then TLS verification will
129 be used. If set to false, then TLS verification will not be used. If
130 not specified, TLS verification will be used unless the target registry
131 is listed as an insecure registry in registries.conf. (Not available
132 for remote commands)
133 --help, -h
136 Print usage statement
139
142 $ podman pull alpine:latest
143 Trying to pull registry.access.redhat.com/alpine:latest... Failed
144 Trying to pull registry.fedoraproject.org/alpine:latest... Failed
145 Trying to pull docker.io/library/alpine:latest...Getting image source signatures
146 Copying blob sha256:88286f41530e93dffd4b964e1db22ce4939fffa4a4c665dab8591fbab03d4926
147 1.90 MB / 1.90 MB [========================================================] 0s
148 Copying config sha256:76da55c8019d7a47c347c0dceb7a6591144d232a7dd616242a367b8bed18ecbc
149 1.48 KB / 1.48 KB [========================================================] 0s
150 Writing manifest to image destination
151 Storing signatures
152 04660052281190168dbb2362eb15bf7067a8dc642d2498055e0e72efa961a4b6
153 $ podman pull --authfile temp-auths/myauths.json docker://docker.io/umohnani/finaltest
157 Trying to pull docker.io/umohnani/finaltest:latest...Getting image source signatures
158 Copying blob sha256:6d987f6f42797d81a318c40d442369ba3dc124883a0964d40b0c8f4f7561d913
159 1.90 MB / 1.90 MB [========================================================] 0s
160 Copying config sha256:ad4686094d8f0186ec8249fc4917b71faa2c1030d7b5a025c29f26e19d95c156
161 1.41 KB / 1.41 KB [========================================================] 0s
162 Writing manifest to image destination
163 Storing signatures
164 03290064078cb797f3e0a530e78c20c13dd22a3dd3adf84a5da2127b48df0438
165 $ podman pull --creds testuser:testpassword docker.io/umohnani/finaltest
169 Trying to pull docker.io/umohnani/finaltest:latest...Getting image source signatures
170 Copying blob sha256:6d987f6f42797d81a318c40d442369ba3dc124883a0964d40b0c8f4f7561d913
171 1.90 MB / 1.90 MB [========================================================] 0s
172 Copying config sha256:ad4686094d8f0186ec8249fc4917b71faa2c1030d7b5a025c29f26e19d95c156
173 1.41 KB / 1.41 KB [========================================================] 0s
174 Writing manifest to image destination
175 Storing signatures
176 03290064078cb797f3e0a530e78c20c13dd22a3dd3adf84a5da2127b48df0438
177 $ podman pull --tls-verify=false --cert-dir image/certs docker.io/umohnani/finaltest
181 Trying to pull docker.io/umohnani/finaltest:latest...Getting image source signatures
182 Copying blob sha256:6d987f6f42797d81a318c40d442369ba3dc124883a0964d40b0c8f4f7561d913
183 1.90 MB / 1.90 MB [========================================================] 0s
184 Copying config sha256:ad4686094d8f0186ec8249fc4917b71faa2c1030d7b5a025c29f26e19d95c156
185 1.41 KB / 1.41 KB [========================================================] 0s
186 Writing manifest to image destination
187 Storing signatures
188 03290064078cb797f3e0a530e78c20c13dd22a3dd3adf84a5da2127b48df0438
189
193 registries.conf (/etc/containers/registries.conf)
194 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.
197
201 podman(1), podman-push(1), podman-login(1),
202 containers-registries.conf(5)
203
206 July 2017, Originally compiled by Urvashi Mohnani ⟨umohnani@redhat.com⟩
207 podman-pull(1)