NAME

       gh-auth-login - Authenticate with a GitHub host

SYNOPSIS

       gh auth login [flags]

DESCRIPTION

       Authenticate with a GitHub host.

       The default authentication mode is a web-based browser flow.

       Alternatively,  pass  in  a  token  on  standard input by using --with-token.  The minimum
       required scopes for the token are: "repo", "read:org".

       The --scopes flag accepts a comma separated list of scopes you want your gh credentials to
       have. If absent, this command ensures that gh has access to a minimum set of scopes.

OPTIONS

       -h, --hostname <string>
              The hostname of the GitHub instance to authenticate with

       -s, --scopes <strings>
              Additional authentication scopes for gh to have

       -w, --web
              Open a browser to authenticate

       --with-token
              Read token from standard input

EXAMPLE

              # start interactive setup
              $ gh auth login

              # authenticate against github.com by reading the token from a file
              $ gh auth login --with-token < mytoken.txt

              # authenticate with a specific GitHub Enterprise Server instance
              $ gh auth login --hostname enterprise.internal

SEE ALSO

       gh-auth(1)

                                             Mar 2022                            GH-AUTH-LOGIN(1)