github.com/hanks177/podman/v4@v4.1.3-0.20220613032544-16d90015bc83/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* [*destination*]
     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. (Default true)
    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. (Default: /etc/containers/certs.d)
    33  Please refer to containers-certs.d(5) for details. (This option is not available with the remote Podman client, including Mac and Windows (excluding WSL2) machines)
    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  #### **--quiet**, **-q**
    50  
    51  When writing the manifest, suppress progress output
    52  
    53  #### **--remove-signatures**
    54  
    55  Don't copy signatures when pushing images.
    56  
    57  #### **--rm**
    58  
    59  Delete the manifest list or image index from local storage if pushing succeeds.
    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  ## DESTINATION
    70  
    71   The DESTINATION is a location to store container images
    72   The Image "DESTINATION" uses a "transport":"details" format.
    73   If a transport is not given, podman push will attempt to push
    74   to a registry.
    75  
    76   Multiple transports are supported:
    77  
    78    **dir:**_path_
    79    An existing local directory _path_ storing the manifest, layer tarballs and signatures as individual files. This is a non-standardized format, primarily useful for debugging or noninvasive container inspection.
    80  
    81      $ podman manifest push mylist:v1.11 dir:/tmp/mylist
    82  
    83    **docker://**_docker-reference_
    84    An image in a registry implementing the "Docker Registry HTTP API V2". By default, uses the authorization state in `$XDG_RUNTIME_DIR/containers/auth.json`, which is set using `(podman login)`. If the authorization state is not found there, `$HOME/.docker/config.json` is checked, which is set using `(docker login)`.
    85  
    86      $ podman manifest push mylist:v1.11 docker://registry.example.org/mylist:v1.11
    87  
    88    **docker-archive:**_path_[**:**_docker-reference_]
    89    An image is stored in the `docker save` formatted file.  _docker-reference_ is only used when creating such a file, and it must not contain a digest.
    90  
    91      $ podman manifest push mylist:v1.11 docker-archive:/tmp/mylist
    92  
    93    **docker-daemon:**_docker-reference_
    94    An image in _docker-reference_ format stored in the docker daemon internal storage. _docker-reference_ must contain a tag.
    95  
    96      $ podman manifest push mylist:v1.11 docker-daemon:registry.example.org/mylist:v1.11
    97  
    98    **oci-archive:**_path_**:**_tag_
    99    An image _tag_ in a directory compliant with "Open Container Image Layout Specification" at _path_.
   100  
   101      $ podman manifest push mylist:v1.11 oci-archive:/tmp/mylist
   102  
   103  ## EXAMPLE
   104  
   105  ```
   106  podman manifest push mylist:v1.11 docker://registry.example.org/mylist:v1.11
   107  ```
   108  
   109  ## SEE ALSO
   110  **[podman(1)](podman.1.md)**, **[podman-manifest(1)](podman-manifest.1.md)**