1podman-manifest-add(1)      General Commands Manual     podman-manifest-add(1)
2
3
4

NAME

6       podman-manifest-add - Add an image to a manifest list or image index
7
8

SYNOPSIS

10       podman manifest add [options] listnameorindexname [transport]:imagename
11
12

DESCRIPTION

14       Adds the specified image to the specified manifest list or image index.
15
16

RETURN VALUE

18       The list image's ID.
19
20

OPTIONS

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
29
30   --annotation=annotation=value
31       Set an annotation on the entry for the image.
32
33
34   --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
40
41   --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
47
48       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
52
53   --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
59
60   --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
66
67   --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
71
72   --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
78
79   --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
83
84   --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
91
92   --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
98

Transport

100       Multiple transports are supported:
101
102
103       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
110
111              $ podman manifest add mylist:v1.11 docker://quay.io/username/myimage
112
113
114
115       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
119
120              $ podman manifest add mylist:v1.11 containers-storage:quay.io/username/myimage
121
122
123
124       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
130
131              $ podman manifest add dir:/tmp/myimage
132
133
134
135       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
140
141              $ podman manifest add docker-archive:/tmp/myimage
142
143
144
145       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
150
151              $ sudo podman manifest add docker-daemon:docker.io/library/myimage:33
152
153
154
155       oci-archive:path:tag
156         An image tag in a directory compliant with "Open Container Image Lay‐
157       out Specification" at path.
158
159
160              $ podman manifest add oci-archive:/tmp/myimage
161
162
163

EXAMPLE

165              podman manifest add mylist:v1.11 docker://fedora
166              71c201d10fffdcac52968a000d85a0a016ca1c7d5473948000d3131c1773d965
167
168
169
170              podman manifest add --all mylist:v1.11 docker://fedora
171              71c201d10fffdcac52968a000d85a0a016ca1c7d5473948000d3131c1773d965
172
173
174
175              podman manifest add --arch arm64 --variant v8 mylist:v1.11 docker://71c201d10fffdcac52968a000d85a0a016ca1c7d5473948000d3131c1773d965
176
177
178

SEE ALSO

180       podman(1), podman-manifest(1)
181
182
183
184                                                        podman-manifest-add(1)
Impressum