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

EXAMPLE

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

136       podman(1), podman-manifest(1), podman-manifest-create(1),  podman-mani‐
137       fest-inspect(1),   podman-manifest-push(1),  podman-manifest-remove(1),
138       podman-rmi(1), containers-certs.d(5)
139
140
141
142                                                      podman-manifest-add(1)()