11# Environment variables
22
3- [ Git Credential Manager] [ ] works out of the box for most users. Configuration options are available to customize or tweak behavior.
3+ [ Git Credential Manager] [ gcm ] works out of the box for most users. Configuration options are available to customize or tweak behavior.
44
5- Git Credential Manager (GCM) can be configured using environment variables. ** Environment variables take precedence over [ configuration] [ ] options and enterprise system administrator [ default values] [ ] ** .
5+ Git Credential Manager (GCM) can be configured using environment variables. ** Environment variables take precedence over [ configuration] [ configuration ] options and enterprise system administrator [ default values] [ default-values ] ** .
66
77For the complete list of environment variables GCM understands, see the list below.
88
@@ -156,7 +156,7 @@ export GCM_INTERACTIVE=0
156156
157157Defaults to enabled.
158158
159- ** Also see: [ credential.interactive] [ ] **
159+ ** Also see: [ credential.interactive] [ credential-interactive ] **
160160
161161---
162162
@@ -166,7 +166,7 @@ Define the host provider to use when authenticating.
166166
167167ID|Provider
168168-|-
169- ` auto ` _ (default)_ |_ \[ automatic\] _ ([ learn more] [ ] )
169+ ` auto ` _ (default)_ |_ \[ automatic\] _ ([ learn more] [ autodetect ] )
170170` azure-repos ` |Azure Repos
171171` github ` |GitHub
172172` gitlab ` |GitLab _ (supports OAuth in browser, personal access token and Basic Authentication)_
@@ -190,15 +190,15 @@ SET GCM_PROVIDER=github
190190export GCM_PROVIDER=github
191191```
192192
193- ** Also see: [ credential.provider] [ ] **
193+ ** Also see: [ credential.provider] [ credential-provider ] **
194194
195195---
196196
197197### GCM_AUTHORITY _ (deprecated)_
198198
199199> This setting is deprecated and should be replaced by ` GCM_PROVIDER ` with the corresponding provider ID value.
200200>
201- > See the [ migration guide] [ ] for more information.
201+ > See the [ migration guide] [ migration-guide ] for more information.
202202
203203Select the host provider to use when authenticating by which authority is supported by the providers.
204204
@@ -224,7 +224,7 @@ SET GCM_AUTHORITY=github
224224export GCM_AUTHORITY=github
225225```
226226
227- ** Also see: [ credential.authority] [ ] **
227+ ** Also see: [ credential.authority] [ credential-authority ] **
228228
229229---
230230
@@ -233,7 +233,7 @@ export GCM_AUTHORITY=github
233233Permit or disable GCM from presenting GUI prompts. If an equivalent terminal/
234234text-based prompt is available, that will be shown instead.
235235
236- To disable all interactivity see [ GCM_INTERACTIVE] [ ] .
236+ To disable all interactivity see [ GCM_INTERACTIVE] [ gcm-interactive ] .
237237
238238#### Example
239239
@@ -251,7 +251,7 @@ export GCM_GUI_PROMPT=0
251251
252252Defaults to enabled.
253253
254- ** Also see: [ credential.guiPrompt] [ ] **
254+ ** Also see: [ credential.guiPrompt] [ credential-guiprompt ] **
255255
256256---
257257
@@ -260,7 +260,7 @@ Defaults to enabled.
260260Set the maximum length of time, in milliseconds, that GCM should wait for a
261261network response during host provider auto-detection probing.
262262
263- See [ autodetection] [ ] for more information.
263+ See [ autodetection] [ autodetect ] for more information.
264264
265265** Note:** Use a negative or zero value to disable probing altogether.
266266
@@ -280,7 +280,7 @@ SET GCM_AUTODETECT_TIMEOUT=-1
280280export GCM_AUTODETECT_TIMEOUT=-1
281281```
282282
283- ** Also see: [ credential.autoDetectTimeout] [ ] **
283+ ** Also see: [ credential.autoDetectTimeout] [ credential-autodetecttimeout ] **
284284
285285---
286286
@@ -311,15 +311,15 @@ SET GCM_ALLOW_WINDOWSAUTH=0
311311export GCM_ALLOW_WINDOWSAUTH=0
312312```
313313
314- ** Also see: [ credential.allowWindowsAuth] [ ] **
314+ ** Also see: [ credential.allowWindowsAuth] [ credential-allowwindowsauth ] **
315315
316316---
317317
318318### GCM_HTTP_PROXY _ (deprecated)_
319319
320- > This setting is deprecated and should be replaced by the [ standard ` http.proxy ` Git configuration option] [ ] .
320+ > This setting is deprecated and should be replaced by the [ standard ` http.proxy ` Git configuration option] [ git-httpproxy ] .
321321>
322- > See the [ HTTP proxy configuration] [ ] for more information.
322+ > See the [ HTTP proxy configuration] [ network-http-proxy ] for more information.
323323
324324Configure GCM to use the a proxy for network operations.
325325
@@ -337,7 +337,7 @@ SET GCM_HTTP_PROXY=http://john.doe:password@proxy.contoso.com
337337export GCM_HTTP_PROXY=http://john.doe:password@proxy.contoso.com
338338```
339339
340- ** Also see: [ credential.httpProxy] [ ] **
340+ ** Also see: [ credential.httpProxy] [ credential-httpproxy ] **
341341
342342---
343343
@@ -368,7 +368,7 @@ SET GCM_BITBUCKET_AUTHMODES="oauth,basic"
368368export GCM_BITBUCKET_AUTHMODES=" oauth,basic"
369369```
370370
371- ** Also see: [ credential.bitbucketAuthModes] [ ] **
371+ ** Also see: [ credential.bitbucketAuthModes] [ credential-bitbucketauthmodes ] **
372372
373373---
374374
@@ -401,7 +401,7 @@ export GCM_BITBUCKET_ALWAYS_REFRESH_CREDENTIALS=1
401401
402402Defaults to false/disabled.
403403
404- ** Also see: [ credential.bitbucketAlwaysRefreshCredentials] [ ] **
404+ ** Also see: [ credential.bitbucketAlwaysRefreshCredentials] [ credential-bitbucketalwaysrefreshcredentials ] **
405405
406406---
407407
@@ -433,7 +433,7 @@ SET GCM_GITHUB_AUTHMODES="oauth,basic"
433433export GCM_GITHUB_AUTHMODES=" oauth,basic"
434434```
435435
436- ** Also see: [ credential.gitHubAuthModes] [ github-auth-modes ] **
436+ ** Also see: [ credential.gitHubAuthModes] [ credential-githubauthmodes ] **
437437
438438---
439439
@@ -463,7 +463,7 @@ SET GCM_GITLAB_AUTHMODES="browser"
463463export GCM_GITLAB_AUTHMODES=" browser"
464464```
465465
466- ** Also see: [ credential.gitLabAuthModes] [ gitlab-auth-modes ] **
466+ ** Also see: [ credential.gitLabAuthModes] [ credential-gitlabauthmodes ] **
467467
468468---
469469
@@ -521,7 +521,7 @@ SET GCM_CREDENTIAL_STORE="gpg"
521521export GCM_CREDENTIAL_STORE=" gpg"
522522```
523523
524- ** Also see: [ credential.credentialStore] [ credential-credential-store ] **
524+ ** Also see: [ credential.credentialStore] [ credential-credentialstore ] **
525525
526526---
527527
@@ -548,7 +548,7 @@ SET GCM_CREDENTIAL_CACHE_OPTIONS="--timeout 300"
548548export GCM_CREDENTIAL_CACHE_OPTIONS=" --timeout 300"
549549```
550550
551- ** Also see: [ credential.cacheOptions] [ credential-cache-options ] **
551+ ** Also see: [ credential.cacheOptions] [ credential-cacheoptions ] **
552552
553553---
554554
@@ -576,7 +576,7 @@ export GCM_PLAINTEXT_STORE_PATH=/mnt/external-drive/credentials
576576
577577### GCM_DPAPI_STORE_PATH
578578
579- Specify a custom directory to store DPAPI protected credential files in when [ ` GCM_CREDENTIAL_STORE ` ] ( #GCM_CREDENTIAL_STORE ) is set to ` dpapi ` .
579+ Specify a custom directory to store DPAPI protected credential files in when [ ` GCM_CREDENTIAL_STORE ` ] [ gcm-credential-store ] is set to ` dpapi ` .
580580
581581Defaults to the value ` %USERPROFILE%\.gcm\dpapi_store ` .
582582
@@ -696,43 +696,42 @@ export GCM_AZREPOS_CREDENTIALTYPE="oauth"
696696
697697** Also see: [ credential.azreposCredentialType] [ credential-azrepos-credential-type ] **
698698
699- [ autodetection ] : autodetect.md
699+ [ autodetect ] : autodetect.md
700700[ azure-access-tokens ] : azrepos-users-and-tokens.md
701701[ configuration ] : configuration.md
702- [ credential.allowWindowsAuth ] : environment.md#credentialallowWindowsAuth
703- [ credential. authority ] : configuration.md#credentialauthority-deprecated
704- [ credential.autoDetectTimeout ] : configuration.md#credentialautodetecttimeout
702+ [ credential-allowwindowsauth ] : environment.md#credentialallowWindowsAuth
703+ [ credential- authority ] : configuration.md#credentialauthority-deprecated
704+ [ credential-autodetecttimeout ] : configuration.md#credentialautodetecttimeout
705705[ credential-azrepos-credential-type ] : configuration.md#azreposcredentialtype
706- [ credential.bitbucketAlwaysRefreshCredentials ] : configuration.md#bitbucketAlwaysRefreshCredentials
707- [ credential.bitbucketAuthModes ] : configuration.md#credentialbitbucketAuthModes
708- [ credential-cache-options ] : configuration.md#credentialcacheoptions
709- [ credential-credential-store ] : configuration.md#credentialcredentialstore
706+ [ credential-bitbucketalwaysrefreshcredentials ] : configuration.md#bitbucketAlwaysRefreshCredentials
707+ [ credential-bitbucketauthmodes ] : configuration.md#credentialbitbucketAuthModes
708+ [ credential-cacheoptions ] : configuration.md#credentialcacheoptions
709+ [ credential-credentialstore ] : configuration.md#credentialcredentialstore
710710[ credential-dpapi-store-path ] : configuration.md#credentialdpapistorepath
711- [ credential.guiPrompt ] : configuration.md#credentialguiprompt
712- [ credential.httpProxy ] : configuration.md#credentialhttpProxy-deprecated
713- [ credential.interactive ] : configuration.md#credentialinteractive
711+ [ credential-githubauthmodes ] : configuration.md#credentialgitHubAuthModes
712+ [ credential-gitlabauthmodes ] : configuration.md#credentialgitLabAuthModes
713+ [ credential-guiprompt ] : configuration.md#credentialguiprompt
714+ [ credential-httpproxy ] : configuration.md#credentialhttpProxy-deprecated
715+ [ credential-interactive ] : configuration.md#credentialinteractive
714716[ credential-namespace ] : configuration.md#credentialnamespace
715717[ credential-msauth-flow ] : configuration.md#credentialmsauthflow
716718[ credential-msauth-usebroker ] : configuration.md#credentialmsauthusebroker-experimental
717719[ credential-plain-text-store ] : configuration.md#credentialplaintextstorepath
718- [ credential. provider ] : configuration.md#credentialprovider
720+ [ credential- provider ] : configuration.md#credentialprovider
719721[ credential-stores ] : credstores.md
720- [ default values ] : enterprise-config.md
722+ [ default- values ] : enterprise-config.md
721723[ freedesktop-ss ] : https://specifications.freedesktop.org/secret-service/
722- [ GCM_INTERACTIVE ] : #gcm_interactive
724+ [ gcm ] : usage.md
725+ [ gcm-interactive ] : #gcm_interactive
723726[ gcm-credential-store ] : #GCM_CREDENTIAL_STORE
724727[ gcm-dpapi-store-path ] : #gcm_dpapi_store_path
725728[ gcm-plaintext-store-path ] : #gcm_plaintext_store_path
726729[ gcm-msauth-usebroker ] : #gcm_msauth_usebroker-experimental
727730[ git-cache-options ] : https://git-scm.com/docs/git-credential-cache#_options
728- [ Git Credential Manager ] : usage.md
729731[ git-credential-cache ] : https://git-scm.com/docs/git-credential-cache
730- [ github-auth-modes ] : configuration.md#credentialgitHubAuthModes
731- [ gitlab-auth-modes ] : configuration.md#credentialgitLabAuthModes
732- [ HTTP proxy configuration ] : netconfig.md#http-proxy
733- [ learn more ] : autodetect.md
732+ [ git-httpproxy ] : https://git-scm.com/docs/git-config#Documentation/git-config.txt-httpproxy
733+ [ network-http-proxy ] : netconfig.md#http-proxy
734734[ libsecret ] : https://wiki.gnome.org/Projects/Libsecret
735- [ migration guide ] : migration.md#gcm_authority
735+ [ migration- guide ] : migration.md#gcm_authority
736736[ passwordstore ] : https://www.passwordstore.org/
737- [ standard `http.proxy` Git configuration option ] : https://git-scm.com/docs/git-config#Documentation/git-config.txt-httpproxy
738737[ windows-broker ] : windows-broker.md
0 commit comments