man1/git-credential-cache.1

   1 '\" t
   2 .\"     Title: git-credential-cache
   3 .\"    Author: [FIXME: author] [see http://www.docbook.org/tdg5/en/html/author]
   4 .\" Generator: DocBook XSL Stylesheets v1.79.2 <http://docbook.sf.net/>
   5 .\"      Date: 2024-09-25
   6 .\"    Manual: Git Manual
   7 .\"    Source: Git 2.47.0.rc0
   8 .\"  Language: English
   9 .\"
  10 .TH "GIT\-CREDENTIAL\-CACHE" "1" "2024-09-25" "Git 2\&.47\&.0\&.rc0" "Git Manual"
  11 .\" -----------------------------------------------------------------
  12 .\" * Define some portability stuff
  13 .\" -----------------------------------------------------------------
  14 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  15 .\" http://bugs.debian.org/507673
  16 .\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
  17 .\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  18 .ie \n(.g .ds Aq \(aq
  19 .el       .ds Aq '
  20 .\" -----------------------------------------------------------------
  21 .\" * set default formatting
  22 .\" -----------------------------------------------------------------
  23 .\" disable hyphenation
  24 .nh
  25 .\" disable justification (adjust text to left margin only)
  26 .ad l
  27 .\" -----------------------------------------------------------------
  28 .\" * MAIN CONTENT STARTS HERE *
  29 .\" -----------------------------------------------------------------
  30 .SH "NAME"
  31 git-credential-cache \- Helper to temporarily store passwords in memory
  32 .SH "SYNOPSIS"
  33 .sp
  34 .nf
  35 git config credential\&.helper \*(Aqcache [<options>]\*(Aq
  36 .fi
  37 .SH "DESCRIPTION"
  38 .sp
  39 This command caches credentials for use by future Git programs\&. The stored credentials are kept in memory of the cache\-daemon process (instead of being written to a file) and are forgotten after a configurable timeout\&. Credentials are forgotten sooner if the cache\-daemon dies, for example if the system restarts\&. The cache is accessible over a Unix domain socket, restricted to the current user by filesystem permissions\&.
  40 .sp
  41 You probably don\(cqt want to invoke this command directly; it is meant to be used as a credential helper by other parts of Git\&. See \fBgitcredentials\fR(7) or \fBEXAMPLES\fR below\&.
  42 .SH "OPTIONS"
  43 .PP
  44 \-\-timeout <seconds>
  45 .RS 4
  46 Number of seconds to cache credentials (default: 900)\&.
  47 .RE
  48 .PP
  49 \-\-socket <path>
  50 .RS 4
  51 Use
  52 \fB<path>\fR
  53 to contact a running cache daemon (or start a new cache daemon if one is not started)\&. Defaults to
  54 \fB$XDG_CACHE_HOME/git/credential/socket\fR
  55 unless
  56 \fB~/\&.git\-credential\-cache/\fR
  57 exists in which case
  58 \fB~/\&.git\-credential\-cache/socket\fR
  59 is used instead\&. If your home directory is on a network\-mounted filesystem, you may need to change this to a local filesystem\&. You must specify an absolute path\&.
  60 .RE
  61 .SH "CONTROLLING THE DAEMON"
  62 .sp
  63 If you would like the daemon to exit early, forgetting all cached credentials before their timeout, you can issue an \fBexit\fR action:
  64 .sp
  65 .if n \{\
  66 .RS 4
  67 .\}
  68 .nf
  69 git credential\-cache exit
  70 .fi
  71 .if n \{\
  72 .RE
  73 .\}
  74 .SH "EXAMPLES"
  75 .sp
  76 The point of this helper is to reduce the number of times you must type your username or password\&. For example:
  77 .sp
  78 .if n \{\
  79 .RS 4
  80 .\}
  81 .nf
  82 $ git config credential\&.helper cache
  83 $ git push http://example\&.com/repo\&.git
  84 Username: <type your username>
  85 Password: <type your password>
  86
  87 [work for 5 more minutes]
  88 $ git push http://example\&.com/repo\&.git
  89 [your credentials are used automatically]
  90 .fi
  91 .if n \{\
  92 .RE
  93 .\}
  94 .sp
  95 You can provide options via the credential\&.helper configuration variable (this example increases the cache time to 1 hour):
  96 .sp
  97 .if n \{\
  98 .RS 4
  99 .\}
 100 .nf
 101 $ git config credential\&.helper \*(Aqcache \-\-timeout=3600\*(Aq
 102 .fi
 103 .if n \{\
 104 .RE
 105 .\}
 106 .SH "GIT"
 107 .sp
 108 Part of the \fBgit\fR(1) suite