mirror of
https://github.com/git/git
synced 2024-08-25 10:45:59 +00:00
76 lines
2.1 KiB
Plaintext
76 lines
2.1 KiB
Plaintext
![]() |
git-credential-store(1)
|
||
|
=======================
|
||
|
|
||
|
NAME
|
||
|
----
|
||
|
git-credential-store - helper to store credentials on disk
|
||
|
|
||
|
SYNOPSIS
|
||
|
--------
|
||
|
-------------------
|
||
|
git config credential.helper 'store [options]'
|
||
|
-------------------
|
||
|
|
||
|
DESCRIPTION
|
||
|
-----------
|
||
|
|
||
|
NOTE: Using this helper will store your passwords unencrypted on disk,
|
||
|
protected only by filesystem permissions. If this is not an acceptable
|
||
|
security tradeoff, try linkgit:git-credential-cache[1], or find a helper
|
||
|
that integrates with secure storage provided by your operating system.
|
||
|
|
||
|
This command stores credentials indefinitely on disk for use by future
|
||
|
git programs.
|
||
|
|
||
|
You probably don't want to invoke this command directly; it is meant to
|
||
|
be used as a credential helper by other parts of git. See
|
||
|
linkgit:gitcredentials[7] or `EXAMPLES` below.
|
||
|
|
||
|
OPTIONS
|
||
|
-------
|
||
|
|
||
|
--store=<path>::
|
||
|
|
||
|
Use `<path>` to store credentials. The file will have its
|
||
|
filesystem permissions set to prevent other users on the system
|
||
|
from reading it, but will not be encrypted or otherwise
|
||
|
protected. Defaults to `~/.git-credentials`.
|
||
|
|
||
|
EXAMPLES
|
||
|
--------
|
||
|
|
||
|
The point of this helper is to reduce the number of times you must type
|
||
|
your username or password. For example:
|
||
|
|
||
|
------------------------------------------
|
||
|
$ git config credential.helper store
|
||
|
$ git push http://example.com/repo.git
|
||
|
Username: <type your username>
|
||
|
Password: <type your password>
|
||
|
|
||
|
[several days later]
|
||
|
$ git push http://example.com/repo.git
|
||
|
[your credentials are used automatically]
|
||
|
------------------------------------------
|
||
|
|
||
|
STORAGE FORMAT
|
||
|
--------------
|
||
|
|
||
|
The `.git-credentials` file is stored in plaintext. Each credential is
|
||
|
stored on its own line as a URL like:
|
||
|
|
||
|
------------------------------
|
||
|
https://user:pass@example.com
|
||
|
------------------------------
|
||
|
|
||
|
When git needs authentication for a particular URL context,
|
||
|
credential-store will consider that context a pattern to match against
|
||
|
each entry in the credentials file. If the protocol, hostname, and
|
||
|
username (if we already have one) match, then the password is returned
|
||
|
to git. See the discussion of configuration in linkgit:gitcredentials[7]
|
||
|
for more information.
|
||
|
|
||
|
GIT
|
||
|
---
|
||
|
Part of the linkgit:git[1] suite
|