buildah-manifest-push(1) General Commands Manual buildah-manifest-push(1)
NAME
buildah-manifest-push - Push a manifest list or image index to a reg-
istry.
SYNOPSIS
buildah manifest push [options...] listNameOrIndexName transport:details
DESCRIPTION
Pushes a manifest list or image index to a registry.
RETURN VALUE
The list image's ID and the digest of the image's manifest.
OPTIONS
--add-compression compression
Makes sure that requested compression variant for each platform is added
to the manifest list keeping original instance intact in the same mani-
fest list. Supported values are (gzip, zstd and zstd:chunked)
Note: This is different than --compression which replaces the instance
with requested with specified compression while --add-compression makes
sure than each instance has it variant added to manifest list without
modifying the original instance.
--all
Push the images mentioned in the manifest list or image index, in addi-
tion to the list or index itself. (Default true)
--authfile path
Path of the authentication file. Default is ${XDG_RUNTIME_DIR}/contain-
ers/auth.json, which is set using buildah login. If the authorization
state is not found there, $HOME/.docker/config.json is checked, which is
set using docker login.
--cert-dir path
Use certificates at path (*.crt, *.cert, *.key) to connect to the reg-
istry. The default certificates directory is /etc/containers/certs.d.
--compression-format format
Specifies the compression format to use. Supported values are: gzip,
zstd and zstd:chunked.
--compression-level level
Specify the compression level used with the compression.
Specifies the compression level to use. The value is specific to the
compression algorithm used, e.g. for zstd the accepted values are in the
range 1-20 (inclusive), while for gzip it is 1-9 (inclusive).
--creds creds
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 with-
out echo.
--digestfile Digestfile
After copying the image, write the digest of the resulting image to the
file.
--force-compression
If set, push uses the specified compression algorithm even if the desti-
nation contains a differently-compressed variant already. Defaults to
true if --compression-format is explicitly specified on the command-
line, false otherwise.
--format, -f
Manifest list type (oci or v2s2) to use when pushing the list (default
is oci).
--quiet, -q
Don't output progress information when pushing lists.
--remove-signatures
Don't copy signatures when pushing images.
--retry attempts
Number of times to retry in case of failure when performing push of im-
ages to registry.
Defaults to 3.
--retry-delay duration
Duration of delay between retry attempts in case of failure when per-
forming push of images to registry.
Defaults to 2s.
--rm
Delete the manifest list or image index from local storage if pushing
succeeds.
--sign-by fingerprint
Sign the pushed images using the GPG key that matches the specified fin-
gerprint.
--tls-verify bool-value
Require HTTPS and verification of certificates when talking to container
registries (defaults to true). TLS verification cannot be used when
talking to an insecure registry.
EXAMPLE
buildah manifest push mylist:v1.11 registry.example.org/mylist:v1.11
SEE ALSO
buildah(1), buildah-login(1), buildah-manifest(1), buildah-manifest-cre-
ate(1), buildah-manifest-add(1), buildah-manifest-remove(1), buildah-
manifest-annotate(1), buildah-manifest-inspect(1), buildah-rmi(1),
docker-login(1)
buildah September 2019 buildah-manifest-push(1)
Generated by dwww version 1.16 on Tue Dec 16 06:02:11 CET 2025.