% containers-auth.json(5)

NAME

containers-auth.json - syntax for the registry authentication file

DESCRIPTION

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

FORMAT

The auth.json file stores encrypted authentication information for the user to container image registries. The file can have zero to many entries and is created by a login command from a container tool such as podman login or buildah login. Each entry includes the name of the registry and then an auth token in the form of a base64 encoded string from the concatenation of the username, a colon, and the password.

The following example shows the values found in auth.json after the user logged in to their accounts on quay.io and docker.io:

{
    "auths": {
        "docker.io": {
            "auth": "erfi7sYi89234xJUqaqxgmzcnQ2rRFWM5aJX0EC="
        },
        "quay.io": {
            "auth": "juQAqGmz5eR1ipzx8Evn6KGdw8fEa1w5MWczmgY="
        }
    }
}

An entry can be removed by using a logout command from a container tool such as podman logout or buildah logout.

SEE ALSO

buildah-login(1), buildah-logout(1), podman-login(1), podman-logout(1)

HISTORY

Feb 2020, Originally compiled by Tom Sweeney tsweeney@redhat.com