github.com/hanks177/podman/v4@v4.1.3-0.20220613032544-16d90015bc83/docs/source/markdown/podman-manifest-add.1.md (about)

     1  % podman-manifest-add(1)
     2  
     3  ## NAME
     4  podman\-manifest\-add - Add an image to a manifest list or image index
     5  
     6  ## SYNOPSIS
     7  **podman manifest add** [*options*] *listnameorindexname* [*transport*]:*imagename*
     8  
     9  ## DESCRIPTION
    10  
    11  Adds the specified image to the specified manifest list or image index.
    12  
    13  ## RETURN VALUE
    14  The list image's ID.
    15  
    16  ## OPTIONS
    17  
    18  #### **--all**
    19  
    20  If the image which should be added to the list or index is itself a list or
    21  index, add all of the contents to the local list.  By default, only one image
    22  from such a list or index will be added to the list or index.  Combining
    23  *--all* with any of the other options described below is NOT recommended.
    24  
    25  #### **--annotation** *annotation=value*
    26  
    27  Set an annotation on the entry for the newly-added image.
    28  
    29  #### **--arch**
    30  
    31  Override the architecture which the list or index records as a requirement for
    32  the image.  If *imageName* refers to a manifest list or image index, the
    33  architecture information will be retrieved from it.  Otherwise, it will be
    34  retrieved from the image's configuration information.
    35  
    36  #### **--authfile**=*path*
    37  
    38  Path of the authentication file. Default is ${XDG\_RUNTIME\_DIR}/containers/auth.json, which is set using `podman login`.
    39  If the authorization state is not found there, $HOME/.docker/config.json is checked, which is set using `docker login`.
    40  
    41  Note: You can also override the default path of the authentication file by setting the REGISTRY\_AUTH\_FILE
    42  environment variable. `export REGISTRY_AUTH_FILE=path`
    43  
    44  #### **--cert-dir**=*path*
    45  
    46  Use certificates at *path* (\*.crt, \*.cert, \*.key) to connect to the registry. (Default: /etc/containers/certs.d)
    47  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)
    48  
    49  #### **--creds**=*creds*
    50  
    51  The [username[:password]] to use to authenticate with the registry if required.
    52  If one or both values are not supplied, a command line prompt will appear and the
    53  value can be entered.  The password is entered without echo.
    54  
    55  #### **--features**
    56  
    57  Specify the features list which the list or index records as requirements for
    58  the image.  This option is rarely used.
    59  
    60  #### **--os**
    61  
    62  Override the OS which the list or index records as a requirement for the image.
    63  If *imagename* refers to a manifest list or image index, the OS information
    64  will be retrieved from it.  Otherwise, it will be retrieved from the image's
    65  configuration information.
    66  
    67  #### **--os-version**
    68  
    69  Specify the OS version which the list or index records as a requirement for the
    70  image.  This option is rarely used.
    71  
    72  #### **--tls-verify**
    73  
    74  Require HTTPS and verify certificates when talking to container registries (defaults to true).
    75  
    76  #### **--variant**
    77  
    78  Specify the variant which the list or index records for the image.  This option
    79  is typically used to distinguish between multiple entries which share the same
    80  architecture value, but which expect different versions of its instruction set.
    81  
    82  ## Transport
    83  
    84   Multiple transports are supported:
    85  
    86    **docker://**_docker-reference_ _(default)_
    87    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)`.
    88  
    89      $ podman manifest add mylist:v1.11 docker://quay.io/username/myimage
    90  
    91    **containers-storage:**_oci-reference_
    92    An image in _oci-reference_ format stored in the local container storage. _oci-reference_ must contain a tag.
    93  
    94      $ podman manifest add mylist:v1.11 containers-storage:quay.io/username/myimage
    95  
    96    **dir:**_path_
    97    An existing local directory _path_ storing the manifest, layer tarballs, and signatures as individual files. This
    98    is a non-standardized format, primarily useful for debugging or noninvasive container inspection.
    99  
   100      $ podman manifest add dir:/tmp/myimage
   101  
   102    **docker-archive:**_path_[**:**_docker-reference_]
   103    An image is stored in the `docker save` formatted file.  _docker-reference_ is only used when creating such a
   104    file, and it must not contain a digest.
   105  
   106      $ podman manifest add docker-archive:/tmp/myimage
   107  
   108    **docker-daemon:**_docker-reference_
   109    An image in _docker-reference_ format stored in the docker daemon internal storage. The _docker-reference_ can also be an image ID (docker-daemon:algo:digest).
   110  
   111      $ sudo podman manifest add docker-daemon:docker.io/library/myimage:33
   112  
   113    **oci-archive:**_path_**:**_tag_
   114    An image _tag_ in a directory compliant with "Open Container Image Layout Specification" at _path_.
   115  
   116      $ podman manifest add oci-archive:/tmp/myimage
   117  
   118  ## EXAMPLE
   119  
   120  ```
   121  podman manifest add mylist:v1.11 docker://fedora
   122  71c201d10fffdcac52968a000d85a0a016ca1c7d5473948000d3131c1773d965
   123  ```
   124  
   125  ```
   126  podman manifest add --all mylist:v1.11 docker://fedora
   127  71c201d10fffdcac52968a000d85a0a016ca1c7d5473948000d3131c1773d965
   128  ```
   129  
   130  ```
   131  podman manifest add --arch arm64 --variant v8 mylist:v1.11 docker://71c201d10fffdcac52968a000d85a0a016ca1c7d5473948000d3131c1773d965
   132  ```
   133  
   134  ## SEE ALSO
   135  **[podman(1)](podman.1.md)**, **[podman-manifest(1)](podman-manifest.1.md)**