podman-manifest-push(1)

1podman-manifest-push(1)()                            podman-manifest-push(1)()
2
3
4

NAME

6       podman-manifest-push  -  Push  a manifest list or image index to a reg‐
7       istry
8
9

SYNOPSIS

11       podman manifest push [options] listnameorindexname [destination]
12
13

DESCRIPTION

15       Pushes a manifest list or image index to a registry.
16
17

RETURN VALUE

19       The list image's ID and the digest of the image's manifest.
20
21

OPTIONS

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.  (Default:  /etc/containers/certs.d) Please refer to containers-
43       certs.d(5) for details. (This option is not available with  the  remote
44       Podman client, including Mac and Windows (excluding WSL2) machines)
45
46
47   --creds=creds
48       The  [username[:password]]  to use to authenticate with the registry if
49       required.  If one or both values  are  not  supplied,  a  command  line
50       prompt  will  appear and the value can be entered.  The password is en‐
51       tered without echo.
52
53
54   --digestfile=Digestfile
55       After copying the image, write the digest of the resulting image to the
56       file.
57
58
59   --format, -f=format
60       Manifest  list type (oci or v2s2) to use when pushing the list (default
61       is oci).
62
63
64   --quiet, -q
65       When writing the manifest, suppress progress output
66
67
68   --remove-signatures
69       Don't copy signatures when pushing images.
70
71
72   --rm
73       Delete the manifest list or image index from local storage  if  pushing
74       succeeds.
75
76
77   --sign-by=fingerprint
78       Sign  the  pushed  images  using the GPG key that matches the specified
79       fingerprint.
80
81
82   --tls-verify
83       Require HTTPS and verify certificates when talking  to  container  reg‐
84       istries. (defaults to true)
85
86

DESTINATION

88       The DESTINATION is a location to store container images
89        The Image "DESTINATION" uses a "transport":"details" format.
90        If a transport is not given, podman push will attempt to push
91        to a registry.
92
93
94       Multiple transports are supported:
95
96
97       dir:path
98         An existing local directory path storing the manifest, layer tarballs
99       and signatures as individual files. This is a non-standardized  format,
100       primarily useful for debugging or noninvasive container inspection.
101
102
103              $ podman manifest push mylist:v1.11 dir:/tmp/mylist
104
105
106
107       docker://docker-reference
108         An  image  in  a  registry implementing the "Docker Registry HTTP API
109       V2". By default, uses the authorization state in  $XDG_RUNTIME_DIR/con‐
110       tainers/auth.json, which is set using (podman login). If the authoriza‐
111       tion state is not found there,  $HOME/.docker/config.json  is  checked,
112       which is set using (docker login).
113
114
115              $ podman manifest push mylist:v1.11 docker://registry.example.org/mylist:v1.11
116
117
118
119       docker-archive:path[:docker-reference]
120         An  image is stored in the docker save formatted file.  docker-refer‐
121       ence is only used when creating such a file, and it must not contain  a
122       digest.
123
124
125              $ podman manifest push mylist:v1.11 docker-archive:/tmp/mylist
126
127
128
129       docker-daemon:docker-reference
130         An  image  in docker-reference format stored in the docker daemon in‐
131       ternal storage. docker-reference must contain a tag.
132
133
134              $ podman manifest push mylist:v1.11 docker-daemon:registry.example.org/mylist:v1.11
135
136
137
138       oci-archive:path:tag
139         An image tag in a directory compliant with "Open Container Image Lay‐
140       out Specification" at path.
141
142
143              $ podman manifest push mylist:v1.11 oci-archive:/tmp/mylist
144
145
146

EXAMPLE

148              podman manifest push mylist:v1.11 docker://registry.example.org/mylist:v1.11
149
150
151