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. (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=creds
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 talking  to  container  reg‐
86       istries (defaults to true).
87
88
89   --variant
90       Specify  the  variant  which  the  list or index records for the image.
91       This option is typically used to distinguish between  multiple  entries
92       which  share  the  same  architecture value, but which expect different
93       versions of its instruction set.
94
95

Transport

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

EXAMPLE

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