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.  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

DESTINATION

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

EXAMPLE

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