Skip to content
This repository has been archived by the owner on Jul 15, 2023. It is now read-only.

Latest commit

 

History

History
163 lines (88 loc) · 5.31 KB

Environment.md

File metadata and controls

163 lines (88 loc) · 5.31 KB

Environment Variables

Git Credential Manager and Git Askpass work out of the box for most users. Environment variables, to customize or tweak behavior, are available as needed.

The Git Credential Manager for Windows [GCM] can be configured using environment variables. Environment variables take precedence over configuration settings.

For the complete list of environment variables the GCM understands, see the list below.

Configuration Setting Names

GCM_AUTHORITY

Defines the type of authentication to be used.

Supports Auto, Basic, AAD, MSA, GitHub, Bitbucket, Integrated, and NTLM.

Use AAD or MSA if the host is 'visualstudio.com' Azure Domain or Live Account authentication, relatively.

Use GitHub if the host is 'github.com'.

Use BitBucket or Atlassian if the host is 'bitbucket.org'.

Use Integrated or NTLM if the host is a Team Foundation, or other NTLM authentication based, server.

Defaults to Auto.

See credential.authority.

GCM_CONFIG_NOLOCAL

Determines if the the GCM should ignore Git local configuration values.

Supports true or false. Defaults to false.

No configuration equivalent.

GCM_CONFIG_NOSYSTEM

Determines if the the GCM should ignore Git system configuration values.

Supports true or false. Defaults to false.

No configuration equivalent.

HTTP_PROXY / HTTPS_PROXY

Causes the proxy value to be considered when evaluating credential target information. A proxy setting should established if use of a proxy is required to interact with Git remotes.

The value should the URL of the proxy server.

Defaults to not using a proxy server.

See credential.httpProxy.

GCM_HTTP_USER_AGENT

Sets the reported user-agent when GCM performs network operations.

Defaults to the GCM's user-agent.

No configuration equivalent.

GCM_INTERACTIVE

Specifies if user can be prompted for credentials or not.

Supports Auto, Always, or Never. Defaults to Auto.

See credential.interactive.

GCM_MODAL_PROMPT

Forces authentication to use a modal dialog instead of asking for credentials at the command prompt.

Supports true or false. Defaults to true.

See credential.modalPrompt.

GCM_NAMESPACE

Sets the namespace for stored credentials.

By default the GCM uses the 'git' namespace for all stored credentials, setting this configuration value allows for control of the namespace used globally, or per host.

See credential.namespace.

GCM_PRESERVE

Prevents the deletion of credentials even when they are reported as invalid by Git. Can lead to lockout situations once credentials expire and until those credentials are manually removed.

Supports true or false. Defaults to false.

See credential.preserve.

GCM_HTTP_TIMEOUT

Sets the maximum time, in milliseconds, for a network request to wait before timing out. This allows changing the default for slow connections.

Supports an integer value. Defaults to 90,000 miliseconds.

See credential.httpTimeout.

GCM_TOKEN_DURATION

Sets a duration, in hours, limit for the validity of Personal Access Tokens requested from Azure DevOps.

If the value is greater than the maximum duration set for the account, the account value supersedes. The value cannot be less than a one hour (1).

Defaults to the account token duration. Honored when authority is set to AAD or MSA.

See credential.tokenDuration.

GCM_TRACE

Enables trace logging of all activities. Configuring Git and the GCM to trace to the same location is often desirable, and the GCM is compatible and cooperative with GIT_TRACE.

Example:

SET GIT_TRACE=%UserProfile%\git.log
SET GCM_TRACE=%UserProfile%\git.log

If the value of GCM_TRACE is a full path to a file in an existing directory, logs are appended to the file.

IF the value of GCM_TRACE is true, logs are written standard error.

Defaults tracing being disabled.

No configuration equivalent.

GCM_VALIDATE

Causes validation of credentials before supplying them to Git. Invalid credentials get a refresh attempt before failing. Incurs minor network operation overhead.

Defaults to true. Ignored when authority set to Basic.

See credential.validate.

GCM_VSTS_SCOPE

Overrides GCM default scope request when generating a Personal Access Token from Azure DevOps. The supported format is one or more scope values separated by whitespace, commas, semi-colons, or pipe characters (' ', ',', ';', '|').

Defaults to vso.code_write|vso.packaging; Honored when host is 'visualstudio.com'.

See credential.vstsScope.

GCM_WRITELOG

Enables trace logging of all activities. Logs are written to the local .git/ folder at the root of the repository.

Note: This setting will not override the GCM_TRACE environment variable.

See credential.writeLog.