1podman-manifest-push(1)() podman-manifest-push(1)()
2
3
4
6 podman-manifest-push - Push a manifest list or image index to a reg‐
7 istry
8
9
11 podman manifest push [options] listnameorindexname [destination]
12
13
15 Pushes a manifest list or image index to a registry.
16
17
19 The list image's ID and the digest of the image's manifest.
20
21
23 --all
24 Push the images mentioned in the manifest list or image index, in addi‐
25 tion to the list or index itself. (Default true)
26
27
28 --authfile=path
29 Path of the authentication file. Default is ${XDG_RUNTIME_DIR}/contain‐
30 ers/auth.json, which is set using podman login. If the authorization
31 state is not found there, $HOME/.docker/config.json is checked, which
32 is set using docker login.
33
34
35 Note: You can also override the default path of the authentication file
36 by setting the REGISTRY_AUTH_FILE environment variable. export REG‐
37 ISTRY_AUTH_FILE=path
38
39
40 --cert-dir=path
41 Use certificates at path (*.crt, *.cert, *.key) to connect to the reg‐
42 istry. Please refer to containers-certs.d(5) for details. (This option
43 is not available with the remote Podman client)
44
45
46 --creds=creds
47 The [username[:password]] to use to authenticate with the registry if
48 required. If one or both values are not supplied, a command line
49 prompt will appear and the value can be entered. The password is en‐
50 tered without echo.
51
52
53 --digestfile=Digestfile
54 After copying the image, write the digest of the resulting image to the
55 file.
56
57
58 --format, -f=format
59 Manifest list type (oci or v2s2) to use when pushing the list (default
60 is oci).
61
62
63 --quiet, -q
64 When writing the manifest, suppress progress output
65
66
67 --rm
68 Delete the manifest list or image index from local storage if pushing
69 succeeds.
70
71
72 --remove-signatures
73 Don't copy signatures when pushing images.
74
75
76 --sign-by=fingerprint
77 Sign the pushed images using the GPG key that matches the specified
78 fingerprint.
79
80
81 --tls-verify
82 Require HTTPS and verify certificates when talking to container reg‐
83 istries. (defaults to true)
84
85
87 The DESTINATION is a location to store container images
88 The Image "DESTINATION" uses a "transport":"details" format.
89 If a transport is not given, podman push will attempt to push
90 to a registry.
91
92
93 Multiple transports are supported:
94
95
96 dir:path
97 An existing local directory path storing the manifest, layer tarballs
98 and signatures as individual files. This is a non-standardized format,
99 primarily useful for debugging or noninvasive container inspection.
100
101
102 $ podman manfiest push mylist:v1.11 dir:/tmp/mylist
103
104
105
106 docker://docker-reference
107 An image in a registry implementing the "Docker Registry HTTP API
108 V2". By default, uses the authorization state in $XDG_RUNTIME_DIR/con‐
109 tainers/auth.json, which is set using (podman login). If the authoriza‐
110 tion state is not found there, $HOME/.docker/config.json is checked,
111 which is set using (docker login).
112
113
114 $ podman manfiest push mylist:v1.11 docker://registry.example.org/mylist:v1.11
115
116
117
118 docker-archive:path[:docker-reference]
119 An image is stored in the docker save formatted file. docker-refer‐
120 ence is only used when creating such a file, and it must not contain a
121 digest.
122
123
124 $ podman manfiest push mylist:v1.11 docker-archive:/tmp/mylist
125
126
127
128 docker-daemon:docker-reference
129 An image in docker-reference format stored in the docker daemon in‐
130 ternal storage. docker-reference must contain a tag.
131
132
133 $ podman manfiest push mylist:v1.11 docker-daemon:registry.example.org/mylist:v1.11
134
135
136
137 oci-archive:path:tag
138 An image tag in a directory compliant with "Open Container Image Lay‐
139 out Specification" at path.
140
141
142 $ podman manifest push mylist:v1.11 oci-archive:/tmp/mylist
143
144
145
147 podman manifest push mylist:v1.11 docker://registry.example.org/mylist:v1.11
148
149
150
152 podman(1), podman-manifest(1), podman-manifest-add(1), podman-mani‐
153 fest-create(1), podman-manifest-inspect(1), podman-manifest-remove(1),
154 podman-rmi(1), containers-certs.d(5)
155
156
157
158 podman-manifest-push(1)()