Ubuntu Manpage: podman-login - Login to a container registry

Provided by: podman_4.3.1+ds1-5ubuntu1_amd64

NAME

       podman-login - Login to a container registry

SYNOPSIS

       podman login [options] [registry]

DESCRIPTION

       podman login logs into a specified registry server with the correct username and password.
       If the registry is not  specified,  the  first  registry  under  [registries.search]  from
       registries.conf  will be used. podman login reads in the username and password from STDIN.
       The username and password can also be set using the username and password flags.  The path
       of  the authentication file can be specified by the user by setting the authfile flag. The
       default      path      for      reading       and       writing       credentials       is
       ${XDG_RUNTIME_DIR}/containers/auth.json.  Podman will use existing credentials if the user
       does not pass in a username.  Podman will first search for the username  and  password  in
       the  ${XDG_RUNTIME_DIR}/containers/auth.json,  if they are not valid, Podman will then use
       any existing credentials found in $HOME/.docker/config.json.  If those credentials are not
       present,  Podman will create ${XDG_RUNTIME_DIR}/containers/auth.json (if the file does not
       exist) and will then store the username and password from STDIN as a base64 encoded string
       in  it.   For  more  details about format and configurations of the auth.json file, please
       refer to containers-auth.json(5)

       podman [GLOBAL OPTIONS]

       podman login [GLOBAL OPTIONS]

       podman login [OPTIONS] [REGISTRY] [GLOBAL OPTIONS]

OPTIONS

--authfile=path
Path of the authentication file. Default is ${XDG_RUNTIME_DIR}/containers/auth.json, which
is set using podman login. If the authorization state is not found there,
$HOME/.docker/config.json is checked, which is set using docker login.

Note: There is also the option to override the default path of the authentication file by
setting the REGISTRY_AUTH_FILE environment variable. This can be done with export
REGISTRY_AUTH_FILE=path.

--cert-dir=path
Use certificates at path (*.crt, *.cert, *.key) to connect to the registry. (Default:
/etc/containers/certs.d) Please refer to containers-certs.d(5) for details. (This option
is not available with the remote Podman client, including Mac and Windows (excluding WSL2)
machines)

--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
Password for registry

--password-stdin
Take the password from stdin

--tls-verify
Require HTTPS and verify certificates when contacting registries (default: true). If
explicitly set to true, TLS verification will be used. If set to false, 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 containers-registries.conf(5)

--username, -u=username
Username for registry

--verbose, -v
print detailed information about credential store

EXAMPLES

              $ podman login docker.io
              Username: umohnani
              Password:
              Login Succeeded!

              $ podman login -u testuser -p testpassword localhost:5000
              Login Succeeded!

              $ podman login --authfile authdir/myauths.json docker.io
              Username: umohnani
              Password:
              Login Succeeded!

              $ podman login --tls-verify=false -u test -p test localhost:5000
              Login Succeeded!

              $ podman login --cert-dir /etc/containers/certs.d/ -u foo -p bar localhost:5000
              Login Succeeded!

              $ podman login -u testuser  --password-stdin < testpassword.txt docker.io
              Login Succeeded!

              $ echo $testpassword | podman login -u testuser --password-stdin docker.io
              Login Succeeded!

              $ podman login quay.io --verbose
              Username: myusername
              Password:
              Used: /run/user/1000/containers/auth.json
              Login Succeeded!

HISTORY