1containers-auth.json(5)()                            containers-auth.json(5)()
2
3
4

NAME

6       containers-auth.json - syntax for the registry authentication file
7
8
9

DESCRIPTION

11       A credentials file stored at ${XDG_RUNTIME_DIR}/containers/auth.json in
12       json format used to authenticate against container image registries.
13
14

FORMAT

16       The auth.json file stores encrypted authentication information for  the
17       user  to  container  image  registries.  The file can have zero to many
18       entries and is created by a login command from a container tool such as
19       podman  login  or  buildah  login.  Each entry includes the name of the
20       registry and then an auth token in the form of a base64 encoded  string
21       from the concatenation of the username, a colon, and the password.
22
23
24       The  following  example  shows  the values found in auth.json after the
25       user logged in to their accounts on quay.io and docker.io:
26
27
28              {
29                   "auths": {
30                        "docker.io": {
31                             "auth": "erfi7sYi89234xJUqaqxgmzcnQ2rRFWM5aJX0EC="
32                        },
33                        "quay.io": {
34                             "auth": "juQAqGmz5eR1ipzx8Evn6KGdw8fEa1w5MWczmgY="
35                        }
36                   }
37              }
38
39
40
41       An entry can be removed by using a logout command from a container tool
42       such as podman logout or buildah logout.
43
44
45

SEE ALSO

47              buildah-login(1), buildah-logout(1), podman-login(1), podman-logout(1)
48
49
50
51

HISTORY

53       Feb  2020,  Originally  compiled  by  Tom  Sweeney  tsweeney@redhat.com
54       ⟨mailto:tsweeney@redhat.com⟩
55
56
57
58                                                     containers-auth.json(5)()