--- sidebar_position: 4 description: "Configure git to use gt for credentials" --- # gt auth setup-git Configure git to use gt for credentials ## Synopsis ```text Configure git to ask gt for the credentials of an instance, so that git push and fetch over HTTPS use the active account, or the account of --user. gt's own clone and checkout commands do not need this. Other credential helpers, such as a system keychain, are turned off for the instance: otherwise they answer first and keep a copy of gt's token. --keep-helpers keeps them. ``` ``` gt auth setup-git [flags] ``` ## Examples ``` $ gt auth setup-git $ gt auth setup-git --host gitea.com # Only for the current repository, always as alice $ gt auth setup-git --local --user alice ``` ## Options ``` -h, --help help for setup-git --keep-helpers Keep other credential helpers for the instance; they are asked first and store gt's token --local Configure only the current Git repository instead of global Git configuration ``` ## Options inherited from parent commands ``` --cwd directory Working directory for repository discovery --debug Log the method, URL, status, and duration of each HTTP request to stderr --host URL Gitea instance URL, including any base path --interactive Allow prompts with machine output -q, --jq expression Filter JSON output using a jq expression; implies --json --json fields[="*"] Output JSON with the specified comma-separated fields, or all fields --no-input Disable prompts and implicit editor/browser interactions --remote remote Git remote used for repository discovery -R, --repo OWNER/REPO Select a repository as OWNER/REPO or URL --sudo user Perform API requests as this user (requires an administrator account) --user name Account name on the selected instance -y, --yes Accept confirmations without prompting ``` ## SEE ALSO * [gt auth](../auth/index.md): Authenticate gt and git with Gitea