podman-manifest-add(1)

1podman-manifest-add(1)()                              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 newly-added 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: You can also override the default path of the authentication file
49       by setting the REGISTRY_AUTH_FILE  environment  variable.  export  REG‐
50       ISTRY_AUTH_FILE=path
51
52
53   --cert-dir=path
54       Use  certificates at path (*.crt, *.cert, *.key) to connect to the reg‐
55       istry.  Please refer to containers-certs.d(5) for details. (This option
56       is not available with the remote Podman client)
57
58
59   --creds=creds
60       The  [username[:password]]  to use to authenticate with the registry if
61       required.  If one or both values  are  not  supplied,  a  command  line
62       prompt  will  appear and the value can be entered.  The password is en‐
63       tered without echo.
64
65
66   --features
67       Specify the features list which the list or index records  as  require‐
68       ments for the image.  This option is rarely used.
69
70
71   --os
72       Override  the  OS  which the list or index records as a requirement for
73       the image.  If imagename refers to a manifest list or image index,  the
74       OS  information  will  be retrieved from it.  Otherwise, it will be re‐
75       trieved from the image's configuration information.
76
77
78   --os-version
79       Specify the OS version which the list or index records as a requirement
80       for the image.  This option is rarely used.
81
82
83   --tls-verify
84       Require  HTTPS  and  verify certificates when talking to container reg‐
85       istries (defaults to true).
86
87
88   --variant
89       Specify the variant which the list or  index  records  for  the  image.
90       This  option  is typically used to distinguish between multiple entries
91       which share the same architecture value,  but  which  expect  different
92       versions of its instruction set.
93
94

Transport

96       Multiple transports are supported:
97
98
99       docker://docker-reference (default)
100         An  image  in  a  registry implementing the "Docker Registry HTTP API
101       V2". By default, uses the authorization state in  $XDG_RUNTIME_DIR/con‐
102       tainers/auth.json, which is set using (podman login). If the authoriza‐
103       tion state is not found there,  $HOME/.docker/config.json  is  checked,
104       which is set using (docker login).
105
106
107              $ podman manifest add mylist:v1.11 docker://quay.io/username/myimage
108
109
110
111       containers-storage:oci-reference
112         An  image in oci-reference format stored in the local container stor‐
113       age. oci-reference must contain a tag.
114
115
116              $ podman manifest add mylist:v1.11 containers-storage:quay.io/username/myimage
117
118
119
120       dir:path
121         An existing local directory path storing  the  manifest,  layer  tar‐
122       balls, and signatures as individual files. This
123         is  a non-standardized format, primarily useful for debugging or non‐
124       invasive container inspection.
125
126
127              $ podman manifest add dir:/tmp/myimage
128
129
130
131       docker-archive:path[:docker-reference]
132         An image is stored in the docker save formatted file.   docker-refer‐
133       ence is only used when creating such a
134         file, and it must not contain a digest.
135
136
137              $ podman manifest add docker-archive:/tmp/myimage
138
139
140
141       docker-daemon:docker-reference
142         An  image  in docker-reference format stored in the docker daemon in‐
143       ternal storage. The docker-reference can also be an image  ID  (docker-
144       daemon:algo:digest).
145
146
147              $ sudo podman manifest add docker-daemon:docker.io/library/myimage:33
148
149
150
151       oci-archive:path:tag
152         An image tag in a directory compliant with "Open Container Image Lay‐
153       out Specification" at path.
154
155
156              $ podman manifest add oci-archive:/tmp/myimage
157
158
159

EXAMPLE

161              podman manifest add mylist:v1.11 docker://fedora
162              71c201d10fffdcac52968a000d85a0a016ca1c7d5473948000d3131c1773d965
163
164
165
166              podman manifest add --all mylist:v1.11 docker://fedora
167              71c201d10fffdcac52968a000d85a0a016ca1c7d5473948000d3131c1773d965
168
169
170
171              podman manifest add --arch arm64 --variant v8 mylist:v1.11 docker://71c201d10fffdcac52968a000d85a0a016ca1c7d5473948000d3131c1773d965
172
173
174