.nh
.TH podman\-manifest\-push(1)
.SH NAME
.PP
podman\-manifest\-push \- Push a manifest list or image index to a registry

.SH SYNOPSIS
.PP
\fBpodman manifest push\fP [\fIoptions\fP] \fIlistnameorindexname\fP \fItransport:details\fP

.SH DESCRIPTION
.PP
Pushes a manifest list or image index to a registry.

.SH RETURN VALUE
.PP
The list image's ID and the digest of the image's manifest.

.SH OPTIONS
.SS \fB\-\-all\fP
.PP
Push the images mentioned in the manifest list or image index, in addition to
the list or index itself. (Default true)

.SS \fB\-\-authfile\fP=\fIpath\fP
.PP
Path of the authentication file. Default is ${XDG\_RUNTIME\_DIR}/containers/auth.json, which is set using \fB\fCpodman login\fR\&.
If the authorization state is not found there, $HOME/.docker/config.json is checked, which is set using \fB\fCdocker login\fR\&.

.PP
Note: You can also override the default path of the authentication file by setting the REGISTRY\_AUTH\_FILE
environment variable. \fB\fCexport REGISTRY\_AUTH\_FILE=path\fR

.SS \fB\-\-cert\-dir\fP=\fIpath\fP
.PP
Use certificates at \fIpath\fP (*\&.crt, *\&.cert, *\&.key) to connect to the registry.
Default certificates directory is \fI/etc/containers/certs.d\fP\&. (Not available for remote commands)

.SS \fB\-\-creds\fP=\fIcreds\fP
.PP
The [username[:password]] to use to authenticate with the registry if required.
If one or both values are not supplied, a command line prompt will appear and the
value can be entered.  The password is entered without echo.

.SS \fB\-\-digestfile\fP=\fIDigestfile\fP
.PP
After copying the image, write the digest of the resulting image to the file.

.SS \fB\-\-format\fP, \fB\-f\fP=\fIformat\fP
.PP
Manifest list type (oci or v2s2) to use when pushing the list (default is oci).

.SS \fB\-\-quiet\fP, \fB\-q\fP
.PP
When writing the manifest, suppress progress output

.SS \fB\-\-rm\fP
.PP
Delete the manifest list or image index from local storage if pushing succeeds.

.SS \fB\-\-remove\-signatures\fP
.PP
Don't copy signatures when pushing images.

.SS \fB\-\-sign\-by\fP=\fIfingerprint\fP
.PP
Sign the pushed images using the GPG key that matches the specified fingerprint.

.SS \fB\-\-tls\-verify\fP
.PP
Require HTTPS and verify certificates when talking to container registries. (defaults to true)

.SH EXAMPLE
.PP
.RS

.nf
podman manifest push mylist:v1.11 docker://registry.example.org/mylist:v1.11

.fi
.RE

.SH SEE ALSO
.PP
podman(1), podman\-manifest(1), podman\-manifest\-add(1), podman\-manifest\-create(1), podman\-manifest\-inspect(1), podman\-manifest\-remove(1), podman\-rmi(1)