github.com/containers/podman/v2@v2.2.2-0.20210501105131-c1e07d070c4c/docs/source/markdown/podman-manifest-push.1.md (about)

     1  % podman-manifest-push(1)
     2  
     3  ## NAME
     4  podman\-manifest\-push - Push a manifest list or image index to a registry
     5  
     6  ## SYNOPSIS
     7  **podman manifest push** [*options*] *listnameorindexname* *transport:details*
     8  
     9  ## DESCRIPTION
    10  Pushes a manifest list or image index to a registry.
    11  
    12  ## RETURN VALUE
    13  The list image's ID and the digest of the image's manifest.
    14  
    15  ## OPTIONS
    16  
    17  #### **--all**
    18  
    19  Push the images mentioned in the manifest list or image index, in addition to
    20  the list or index itself.
    21  
    22  #### **--authfile**=*path*
    23  
    24  Path of the authentication file. Default is ${XDG\_RUNTIME\_DIR}/containers/auth.json, which is set using `podman login`.
    25  If the authorization state is not found there, $HOME/.docker/config.json is checked, which is set using `docker login`.
    26  
    27  Note: You can also override the default path of the authentication file by setting the REGISTRY\_AUTH\_FILE
    28  environment variable. `export REGISTRY_AUTH_FILE=path`
    29  
    30  #### **--cert-dir**=*path*
    31  
    32  Use certificates at *path* (\*.crt, \*.cert, \*.key) to connect to the registry.
    33  Default certificates directory is _/etc/containers/certs.d_. (Not available for remote commands)
    34  
    35  #### **--creds**=*creds*
    36  
    37  The [username[:password]] to use to authenticate with the registry if required.
    38  If one or both values are not supplied, a command line prompt will appear and the
    39  value can be entered.  The password is entered without echo.
    40  
    41  #### **--digestfile**=*Digestfile*
    42  
    43  After copying the image, write the digest of the resulting image to the file.
    44  
    45  #### **--format**, **-f**=*format*
    46  
    47  Manifest list type (oci or v2s2) to use when pushing the list (default is oci).
    48  
    49  #### **--purge**
    50  
    51  Delete the manifest list or image index from local storage if pushing succeeds.
    52  
    53  #### **--quiet**, **-q**
    54  
    55  When writing the manifest, suppress progress output
    56  
    57  #### **--remove-signatures**
    58  
    59  Don't copy signatures when pushing images.
    60  
    61  #### **--sign-by**=*fingerprint*
    62  
    63  Sign the pushed images using the GPG key that matches the specified fingerprint.
    64  
    65  #### **--tls-verify**
    66  
    67  Require HTTPS and verify certificates when talking to container registries. (defaults to true)
    68  
    69  ## EXAMPLE
    70  
    71  ```
    72  podman manifest push mylist:v1.11 docker://registry.example.org/mylist:v1.11
    73  ```
    74  
    75  ## SEE ALSO
    76  podman(1), podman-manifest(1), podman-manifest-add(1), podman-manifest-create(1), podman-manifest-inspect(1), podman-manifest-remove(1), podman-rmi(1)