1podman-manifest-add(1) General Commands Manual podman-manifest-add(1)
2
6 podman-manifest-add - Add an image to a manifest list or image index
7
10 podman manifest add [options] listnameorindexname [transport]:imagename
11
14 Adds the specified image to the specified manifest list or image index.
15
18 The list image's ID.
19
22 --all
23 If the image which should be added to the list or index is itself a
24 list or index, add all of the contents to the local list. By default,
25 only one image from such a list or index will be added to the list or
26 index. Combining --all with any of the other options described below
27 is NOT recommended.
28 --annotation=annotation=value
31 Set an annotation on the entry for the image.
32 --arch
35 Override the architecture which the list or index records as a require‐
36 ment for the image. If imageName refers to a manifest list or image
37 index, the architecture information will be retrieved from it. Other‐
38 wise, it will be retrieved from the image's configuration information.
39 --authfile=path
42 Path of the authentication file. Default is ${XDG_RUNTIME_DIR}/contain‐
43 ers/auth.json, which is set using podman login. If the authorization
44 state is not found there, $HOME/.docker/config.json is checked, which
45 is set using docker login.
46 Note: There is also the option to override the default path of the au‐
49 thentication file by setting the REGISTRY_AUTH_FILE environment vari‐
50 able. This can be done with export REGISTRY_AUTH_FILE=path.
51 --cert-dir=path
54 Use certificates at path (*.crt, *.cert, *.key) to connect to the reg‐
55 istry. (Default: /etc/containers/certs.d) Please refer to containers-
56 certs.d(5) for details. (This option is not available with the remote
57 Podman client, including Mac and Windows (excluding WSL2) machines)
58 --creds=[username[:password]]
61 The [username[:password]] to use to authenticate with the registry, if
62 required. If one or both values are not supplied, a command line
63 prompt will appear and the value can be entered. The password is en‐
64 tered without echo.
65 --features
68 Specify the features list which the list or index records as require‐
69 ments for the image. This option is rarely used.
70 --os
73 Override the OS which the list or index records as a requirement for
74 the image. If imagename refers to a manifest list or image index, the
75 OS information will be retrieved from it. Otherwise, it will be re‐
76 trieved from the image's configuration information.
77 --os-version
80 Specify the OS version which the list or index records as a requirement
81 for the image. This option is rarely used.
82 --tls-verify
85 Require HTTPS and verify certificates when contacting registries (de‐
86 fault: true). If explicitly set to true, TLS verification will be
87 used. If set to false, TLS verification will not be used. If not
88 specified, TLS verification will be used unless the target registry is
89 listed as an insecure registry in containers-registries.conf(5)
90 --variant
93 Specify the variant which the list or index records for the image.
94 This option is typically used to distinguish between multiple entries
95 which share the same architecture value, but which expect different
96 versions of its instruction set.
97
100 Multiple transports are supported:
101 docker://docker-reference (default)
104 An image in a registry implementing the "Docker Registry HTTP API
105 V2". By default, uses the authorization state in $XDG_RUNTIME_DIR/con‐
106 tainers/auth.json, which is set using (podman login). If the authoriza‐
107 tion state is not found there, $HOME/.docker/config.json is checked,
108 which is set using (docker login).
109 $ podman manifest add mylist:v1.11 docker://quay.io/username/myimage
112 containers-storage:oci-reference
116 An image in oci-reference format stored in the local container stor‐
117 age. oci-reference must contain a tag.
118 $ podman manifest add mylist:v1.11 containers-storage:quay.io/username/myimage
121 dir:path
125 An existing local directory path storing the manifest, layer tar‐
126 balls, and signatures as individual files. This
127 is a non-standardized format, primarily useful for debugging or non‐
128 invasive container inspection.
129 $ podman manifest add dir:/tmp/myimage
132 docker-archive:path[:docker-reference]
136 An image is stored in the docker save formatted file. docker-refer‐
137 ence is only used when creating such a
138 file, and it must not contain a digest.
139 $ podman manifest add docker-archive:/tmp/myimage
142 docker-daemon:docker-reference
146 An image in docker-reference format stored in the docker daemon in‐
147 ternal storage. The docker-reference can also be an image ID (docker-
148 daemon:algo:digest).
149 $ sudo podman manifest add docker-daemon:docker.io/library/myimage:33
152 oci-archive:path:tag
156 An image tag in a directory compliant with "Open Container Image Lay‐
157 out Specification" at path.
158 $ podman manifest add oci-archive:/tmp/myimage
161
165 podman manifest add mylist:v1.11 docker://fedora
166 71c201d10fffdcac52968a000d85a0a016ca1c7d5473948000d3131c1773d965
167 podman manifest add --all mylist:v1.11 docker://fedora
171 71c201d10fffdcac52968a000d85a0a016ca1c7d5473948000d3131c1773d965
172 podman manifest add --arch arm64 --variant v8 mylist:v1.11 docker://71c201d10fffdcac52968a000d85a0a016ca1c7d5473948000d3131c1773d965
176
180 podman(1), podman-manifest(1)
181 podman-manifest-add(1)