1podman-push(1)() podman-push(1)()
2
6 podman-push - Push an image from local storage to elsewhere
7
10 podman push [options] image [destination]
11 podman image push [options] image [destination]
14
17 Pushes an image from local storage to a specified destination. Push is
18 mainly used to push images to registries, however podman push can be
19 used to save images to tarballs and directories using the following
20 transports: dir:, docker-archive:, docker-daemon:, oci-archive:, and
21 ostree:.
22
25 Image stored in local container/storage
26
29 The DESTINATION is a location to store container images
30 The Image "DESTINATION" uses a "transport":"details" format.
31 If a transport is not given, podman push will attempt to push
32 to a registry.
33 Multiple transports are supported:
36 dir:path
39 An existing local directory path storing the manifest, layer tarballs
40 and signatures as individual files. This is a non-standardized format,
41 primarily useful for debugging or noninvasive container inspection.
42 docker://docker-reference
45 An image in a registry implementing the "Docker Registry HTTP API
46 V2". By default, uses the authorization state in $XDG_RUNTIME_DIR/con‐
47 tainers/auth.json, which is set using (podman login). If the authoriza‐
48 tion state is not found there, $HOME/.docker/config.json is checked,
49 which is set using (docker login).
50 docker-archive:path[:docker-reference]
53 An image is stored in the docker save formatted file. docker-refer‐
54 ence is only used when creating such a file, and it must not contain a
55 digest.
56 docker-daemon:docker-reference
59 An image docker-reference stored in the docker daemon internal stor‐
60 age. docker-reference must contain either a tag or a digest. Alterna‐
61 tively, when reading images, the format can also be docker-dae‐
62 mon:algo:digest (an image ID).
63 oci-archive:path:tag
66 An image tag in a directory compliant with "Open Container Image Lay‐
67 out Specification" at path.
68 ostree:image[@/absolute/repo/path]
71 An image in local OSTree repository. /absolute/repo/path defaults to
72 /ostree/repo.
73
76 --authfile=path
77 Path of the authentication file. Default is ${XDG_RUNTIME_DIR}/contain‐
80 ers/auth.json, which is set using podman login. If the authorization
81 state is not found there, $HOME/.docker/config.json is checked, which
82 is set using docker login. (Not available for remote commands)
83 Note: You can also override the default path of the authentication file
86 by setting the REGISTRY_AUTH_FILE environment variable. export REG‐
87 ISTRY_AUTH_FILE=path
88 --creds=[username[:password]]
91 The [username[:password]] to use to authenticate with the registry if
94 required. If one or both values are not supplied, a command line
95 prompt will appear and the value can be entered. The password is
96 entered without echo.
97 --cert-dir=path
100 Use certificates at path (*.crt, *.cert, *.key) to connect to the reg‐
103 istry. Default certificates directory is /etc/containers/certs.d. (Not
104 available for remote commands)
105 --compress
108 Compress tarball image layers when pushing to a directory using the
111 'dir' transport. (default is same compression type, compressed or
112 uncompressed, as source) Note: This flag can only be set when using the
113 dir transport
114 --digestfile Digestfile
117 After copying the image, write the digest of the resulting image to the
120 file. (Not available for remote commands)
121 --format, -f=format
124 Manifest Type (oci, v2s1, or v2s2) to use when pushing an image to a
127 directory using the 'dir:' transport (default is manifest type of
128 source) Note: This flag can only be set when using the dir transport
129 --quiet, -q
132 When writing the output image, suppress progress output
135 --remove-signatures
138 Discard any pre-existing signatures in the image
141 --sign-by=key
144 Add a signature at the destination using the specified key
147 --tls-verify=true|false
150 Require HTTPS and verify certificates when contacting registries
153 (default: true). If explicitly set to true, then TLS verification will
154 be used. If set to false, then TLS verification will not be used. If
155 not specified, TLS verification will be used unless the target registry
156 is listed as an insecure registry in registries.conf. (Not available
157 for remote commands)
158
161 This example pushes the image specified by the imageID to a local
162 directory in docker format.
163 # podman push imageID dir:/path/to/image
166 This example pushes the image specified by the imageID to a local
169 directory in oci format.
170 # podman push imageID oci-archive:/path/to/layout:image:tag
173 This example pushes the image specified by the imageID to a container
176 registry named registry.example.com
177 # podman push imageID docker://registry.example.com/repository:tag
180 This example pushes the image specified by the imageID to a container
183 registry named registry.example.com and saves the digest in the speci‐
184 fied digestfile.
185 # podman push --digestfile=/tmp/mydigest imageID docker://reg‐
188 istry.example.com/repository:tag
189 This example pushes the image specified by the imageID and puts it into
192 the local docker container store
193 # podman push imageID docker-daemon:image:tag
196 This example pushes the alpine image to umohnani/alpine on dockerhub
199 and reads the creds from the path given to --authfile
200 # podman push --authfile temp-auths/myauths.json alpine docker://docker.io/umohnani/alpine
203 Getting image source signatures
204 Copying blob sha256:5bef08742407efd622d243692b79ba0055383bbce12900324f75e56f589aedb0
205 4.03 MB / 4.03 MB [========================================================] 1s
206 Copying config sha256:ad4686094d8f0186ec8249fc4917b71faa2c1030d7b5a025c29f26e19d95c156
207 1.41 KB / 1.41 KB [========================================================] 1s
208 Writing manifest to image destination
209 Storing signatures
210 This example pushes the rhel7 image to rhel7-dir with the "oci" mani‐
214 fest type
215 # podman push --format oci registry.access.redhat.com/rhel7 dir:rhel7-dir
218 Getting image source signatures
219 Copying blob sha256:9cadd93b16ff2a0c51ac967ea2abfadfac50cfa3af8b5bf983d89b8f8647f3e4
220 71.41 MB / 71.41 MB [======================================================] 9s
221 Copying blob sha256:4aa565ad8b7a87248163ce7dba1dd3894821aac97e846b932ff6b8ef9a8a508a
222 1.21 KB / 1.21 KB [========================================================] 0s
223 Copying config sha256:f1b09a81455c351eaa484b61aacd048ab613c08e4c5d1da80c4c46301b03cf3b
224 3.01 KB / 3.01 KB [========================================================] 0s
225 Writing manifest to image destination
226 Storing signatures
227
231 podman(1), podman-pull(1), podman-login(1)
232 podman-push(1)()