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.

       Note: You can also override the default path of the authentication file by setting the REGISTRY_AUTH_FILE
       environment variable. 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)

   --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=true|false
       Require  HTTPS  and  verify certificates when contacting registries (default: true). If explicitly set to
       true, then TLS verification 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.

   --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!

SEE ALSO

       podman(1),      podman-logout(1),     containers-auth.json(5),     containers-certs.d(5),     containers-
       registries.conf(5)

HISTORY

       August 2017, Originally compiled by Urvashi Mohnani umohnani@redhat.com ⟨mailto:umohnani@redhat.com⟩

                                                                                               podman-login(1)()