buildah-login(1) General Commands Manual buildah-login(1)
NAME
buildah-login - Login to a container registry
SYNOPSIS
buildah login [options] registry
DESCRIPTION
buildah login logs into a specified registry server with the correct
username and password. buildah login reads in the username and password
from STDIN. The username and password can also be set using the user-
name and password flags. The path of the authentication file can be
specified by the user by setting the authfile flag. The default path
used is ${XDG_RUNTIME_DIR}/containers/auth.json. If XDG_RUNTIME_DIR is
not set, the default is /run/user/$UID/containers/auth.json.
buildah [GLOBAL OPTIONS]
buildah login [GLOBAL OPTIONS]
buildah login [OPTIONS] REGISTRY [GLOBAL OPTIONS]
OPTIONS
--authfile
Path of the authentication file. Default is ${XDG_RUNTIME_DIR}/contain-
ers/auth.json. See containers-auth.json(5) for more information. This
file is created using buildah login.
Note: You can also override the default path of the authentication file
by setting the REGISTRY_AUTH_FILE environment variable. export REG-
ISTRY_AUTH_FILE=path
--cert-dir path
Use certificates at path (*.crt, *.cert, *.key) to connect to the reg-
istry. The default certificates directory is /etc/containers/certs.d.
--compat-auth-file=path
Instead of updating the default credentials file, update the one at
path, and use a Docker-compatible format.
--get-login
Return the logged-in user for the registry. Return error if no login is
found.
--help, -h
Print usage statement
--password, -p
Password for registry
--password-stdin
Take the password from stdin
--tls-verify
Require HTTPS and verification of certificates when talking to container
registries (default: true). If explicitly set to true, then TLS verifi-
cation will be used. If set to false, then TLS verification will not be
used. If not specified, TLS verification will be used unless the target
registry is listed as an insecure registry in registries.conf. TLS ver-
ification cannot be used when talking to an insecure registry.
--username, -u
Username for registry
--verbose, -v
print detailed information about credential store
EXAMPLES
$ buildah login quay.io
Username: qiwanredhat
Password:
Login Succeeded!
$ buildah login -u testuser -p testpassword localhost:5000
Login Succeeded!
$ buildah login --authfile ./auth.json quay.io
Username: qiwanredhat
Password:
Login Succeeded!
$ buildah login --tls-verify=false -u test -p test localhost:5000
Login Succeeded!
$ buildah login --cert-dir /etc/containers/certs.d/ -u foo -p bar localhost:5000
Login Succeeded!
$ buildah login -u testuser --password-stdin < pw.txt quay.io
Login Succeeded!
$ echo $testpassword | buildah login -u testuser --password-stdin quay.io
Login Succeeded!
SEE ALSO
buildah(1), buildah-logout(1), containers-auth.json(5)
buildah Apr 2019 buildah-login(1)
Generated by dwww version 1.16 on Tue Dec 16 05:36:02 CET 2025.