I recently switched to synchronizing my repositories to https:// on GitHub (due to firewall issues), and it asks for a password every time.
Is there a way to cache the credentials, instead of authenticating every time that git push
?
I recently switched to synchronizing my repositories to https:// on GitHub (due to firewall issues), and it asks for a password every time.
Is there a way to cache the credentials, instead of authenticating every time that git push
?
Since Git 1.7.9 (released 2012), there is a neat mechanism in Git to avoid having to type your password all the time for HTTP / HTTPS, called credential helpers.
You can just use one of the following credential helpers:
git config --global credential.helper cache
The credential.helper cache value tells Git to keep your password cached in memory for a particular amount of minutes. The default is 15 minutes, you can set a longer timeout with:
# Cache for 1 hour
git config --global credential.helper "cache --timeout=3600"
# Cache for 1 day
git config --global credential.helper "cache --timeout=86400"
# Cache for 1 week
git config --global credential.helper "cache --timeout=604800"
You can also store your credentials permanently if so desired, see the other answers below.
GitHub's help also suggests that if you're on Mac OS X and used Homebrew to install Git, you can use the native Mac OS X keystore with:
git config --global credential.helper osxkeychain
For Windows, there is a helper called Git Credential Manager for Windows or wincred in msysgit.
git config --global credential.helper wincred # obsolete
With Git for Windows 2.7.3+ (March 2016):
git config --global credential.helper manager
For Linux, you would use (in 2011) gnome-keyring
(or other keyring implementation such as KWallet).
Nowadays (2020), that would be (on Linux)
sudo dnf install git-credential-libsecret
git config --global credential.helper /usr/libexec/git-core/git-credential-libsecret
sudo apt-get install libsecret-1-0 libsecret-1-dev
cd /usr/share/doc/git/contrib/credential/libsecret
sudo make
git config --global credential.helper /usr/share/doc/git/contrib/credential/libsecret/git-credential-libsecret
git config --global credential.helper osxkeychain
on OS X. For other OS see help.github.com/articles/set-up-git –
Somatist https
repos urls? or does it work also when using ssh
repos urls + keys? –
Donny https://username:[email protected]/username/project.git
. It makes plain text passwords stored on disk almost safe enough to use. –
Bespectacled ssh-add
). Windows can use Pageant if you have PuTTY. If you're using Linux in a headless environment, there's a little more set up required, but you can easily find a guide on Google. –
Pfeifer you:password@
URL)? When it's stored in my .git directory, and I push updates, and then someone else pulls it from remote, do they have the text file that has my password (you:password@
URL)? –
Anabasis .git/config
isn't pushed up. But it's still bad practice to store plain text passwords locally. –
Somatist git config --global credential.helper cache
doesn't work on windows: stackoverflow.com/questions/11693074/… use gitcredentialstore on Windows an be happy –
Femi git config --global credential.helper cache
didn't work for me on Ubuntu either. –
Luger printf "protocol=https\nhost=git.mycompany.com\n" | git credential-manager get
(more details here). You should always use a personal access token with this, and of course use 2FA on your GitHub account. –
Barnsley git version 2.14.3 (Apple Git-98)
–
Gametangium Password:
, and no other process sees what you enter. Anyone who uses passwords in shell commandlines deserves what they get. (Shows up in ps
while the command is running, too.) But, those of us who don't freak out at the mere sight of a command prompt learned that way back in the 1990s. –
Phototelegraph -1
it should be in the maximum value. –
Fujimoto git
should be using a Unsigned Integer to store the timeout. For understanding purposes see this example, it explains the trick. –
Fujimoto ~138
years. Which might be a bit unrealistic. –
Fujimoto You can also have Git store your credentials permanently using git-credential-store as following:
git config credential.helper store
Note: While this is convenient, Git will store your credentials in clear text in a local file (.git-credentials) under your project directory (see below for the "home" directory). If you don't like this, delete this file and switch to using the cache option.
If you want Git to resume to asking you for credentials every time it needs to connect to the remote repository, you can run this command:
git config --unset credential.helper
To store the passwords in .git-credentials
in your %HOME%
directory as opposed to the project directory: use the --global
flag
git config --global credential.helper store
git config --global credential.helper store
–
Grizzle --global
flag was redundant. Even without this flag, the credentials file was created in %USER_HOME%
directory. –
Mammal git config --global credential.helper "cache --timeout=9999999999"
. That worked for me and is 317 years. –
Windrow Saving a password for a Git repository HTTPS URL is possible with a ~/.netrc
(Unix) or %HOME%/_netrc
(note the _
) on Windows.
But: That file would store your password in plain text.
Solution: Encrypt that file with GPG (GNU Privacy Guard), and make Git decrypt it each time it needs a password (for push
/pull
/fetch
/clone
operation).
Note: with Git 2.18 (Q2 2018), you now can customize the GPG used to decrypt the encrypted .netrc
file.
See commit 786ef50, commit f07eeed (12 May 2018) by Luis Marsano (``).
(Merged by Junio C Hamano -- gitster
-- in commit 017b7c5, 30 May 2018)
git-credential-netrc
: acceptgpg
option
git-credential-netrc
was hardcoded to decrypt with 'gpg
' regardless of the gpg.program option.
This is a problem on distributions like Debian that call modern GnuPG something else, like 'gpg2
'
With Windows:
(Git has a gpg.exe
in its distribution, but using a full GPG installation includes a gpg-agent.exe
, which will memorize your passphrase associated to your GPG key.)
Install gpg4Win Lite
, the minimum gnupg command-line interface (take the most recent gpg4win-vanilla-2.X.Y-betaZZ.exe
), and complete your PATH with the GPG installation directory:
set PATH=%PATH%:C:\path\to\gpg
copy C:\path\to\gpg\gpg2.exe C:\path\to\gpg\gpg.exe
(Note the 'copy
' command: Git will need a Bash script to execute the command 'gpg
'. Since gpg4win-vanilla-2
comes with gpg2.exe
, you need to duplicate it.)
Create or import a GPG key, and trust it:
gpgp --import aKey
# or
gpg --gen-key
(Make sure to put a passphrase to that key.)
Install the credential helper script in a directory within your %PATH%
:
cd c:\a\fodler\in\your\path
curl -o c:\prgs\bin\git-credential-netrc https://raw.githubusercontent.com/git/git/master/contrib/credential/netrc/git-credential-netrc.perl
(Beware: the script is renamed in Git 2.25.x/2.26, see below)
(Yes, this is a Bash script, but it will work on Windows since it will be called by Git.)
Make a _netrc file in clear text
machine a_server.corp.com
login a_login
password a_password
protocol https
machine a_server2.corp.com
login a_login2
password a_password2
protocol https
(Don't forget the 'protocol
' part: 'http
' or 'https
' depending on the URL you will use.)
Encrypt that file:
gpg -e -r a_recipient _netrc
(You now can delete the _netrc
file, keeping only the _netrc.gpg
encrypted one.)
Use that encrypted file:
git config --local credential.helper "netrc -f C:/path/to/_netrc.gpg -v"
(Note the '/
': C:\path\to...
wouldn't work at all.) (You can use at first -v -d
to see what is going on.)
From now on, any Git command using an HTTP(S) URL which requires authentication will decrypt that _netrc.gpg
file and use the login/password associated to the server you are contacting.
The first time, GPG will ask you for the passphrase of your GPG key, to decrypt the file.
The other times, the gpg-agent launched automatically by the first GPG call will provide that passphrase for you.
That way, you can memorize several URLs/logins/passwords in one file, and have it stored on your disk encrypted.
I find it more convenient than a "cache" helper", where you need to remember and type (once per session) a different password for each of your remote services, for said password to be cached in memory.
With Git 2.26 (Q1 2020), the sample credential helper for using .netrc
has been updated to work out of the box. See patch/discussion.
See commit 6579d93, commit 1c78c78 (20 Dec 2019) by Denton Liu (Denton-L
).
(Merged by Junio C Hamano -- gitster
-- in commit 1fd27f8, 25 Dec 2019)
contrib/credential/netrc
: makePERL_PATH
configurableSigned-off-by: Denton Liu
The shebang path for the Perl interpreter in
git-credential-netrc
was hardcoded.
However, some users may have it located at a different location and thus, would have had to manually edit the script.Add a
.perl
prefix to the script to denote it as a template and ignore the generated version.
Augment theMakefile
so that it generatesgit-credential-netrc
fromgit-credential-netrc.perl
, just like other Perl scripts.The Makefile recipes were shamelessly stolen from
contrib/mw-to-git/Makefile
.
And:
With 2.26 (Q1 2020), Sample credential helper for using .netrc has been updated to work out of the box.
See commit 6579d93, commit 1c78c78 (20 Dec 2019) by Denton Liu (Denton-L
).
(Merged by Junio C Hamano -- gitster
-- in commit 1fd27f8, 25 Dec 2019)
contrib/credential/netrc
: work outside a repoSigned-off-by: Denton Liu
Currently,
git-credential-netrc
does not work outside of a git repository. It fails with the following error:fatal: Not a git repository: . at /usr/share/perl5/Git.pm line 214.
There is no real reason why need to be within a repository, though. Credential helpers should be able to work just fine outside the repository as well.
Call the non-self version of
config()
so thatgit-credential-netrc
no longer needs to be run within a repository.
Jeff King (peff
) adds:
I assume you're using a gpg-encrypted
netrc
(if not, you should probably just usecredential-store
).
For "read-only" password access, I find the combination ofpass
with config like this is a bit nicer:[credential "https://github.com"] username = peff helper = "!f() { test $1 = get && echo password=`pass github/oauth`; }; f"
The 2013 "fatal: Not a git repository
" error message with Git.pm is... fixed with Git 2.39 (Q4 2022):
See commit 20da61f (22 Oct 2022) by Jeff King (peff
).
See commit 77a1310 (16 Oct 2022) by Michael McClimon (mmcclimon
).
(Merged by Junio C Hamano -- gitster
-- in commit 330135a, 28 Oct 2022)
Git.pm
: trust rev-parse to find bare repositoriesSigned-off-by: Jeff King
When initializing a repository object, we run "
git rev-parse --git-dir
"(man) to let the C version of Git find the correct directory.
But curiously, if this fails we don't automatically say "not a git repository".
Instead, we do our own pure-Perl check to see if we're in a bare repository.This makes little sense, as rev-parse will report both bare and non-bare directories.
This logic comes from d5c7721 ("Git.pm
: Add support for subdirectories inside of working copies", 2006-06-24, Git v1.4.3-rc1 -- merge), but I don't see any reason given why we can't just rely on rev-parse.
Worse, because we treat any non-error response from rev-parse as a non-bare repository, we'll erroneously set the object'sWorkingCopy
, even in a bare repository.But it gets worse.
Since 8959555 (setup_git_directory()
: add an owner check for the top-level directory, 2022-03-02, Git v2.36.0-rc2 -- merge)(setup_git_directory()
: add an owner check for the top-level directory, 2022-03-02), it's actively wrong (and dangerous).
The Perl code doesn't implement the same ownership checks.
And worse, after "finding" the bare repository, it setsGIT_DIR
in the environment, which tells any subsequent Git commands that we've confirmed the directory is OK, and to trust us.
I.e., it re-opens the vulnerability plugged by 8959555 when usingGit.pm
's repository discovery code.We can fix this by just relying on rev-parse to tell us when we're not in a repository, which fixes the vulnerability.
Furthermore, we'll ask its--is-bare-repository
function to tell us if we're bare or not, and rely on that.
curl -o c:\prgs\bin\git-credential-netrc https://raw.github.com/git/git/master/contrib/credential/netrc/git-credential-netrc
is for: you need to copy the git-credential-netrc
anywhere in your path ($PATH
), in order for git to be able to call 'credential-netrc
'. –
Callista _netrc
didn't work for me on a Windows 7
PC, but the .netrc
worked for youtube-dl with the --netrc
argument passed to it. –
Ergot https://raw.githubusercontent.com/git/git/master/contrib/credential/netrc/git-credential-netrc.perl
(piping in seven years later 😉) –
Treadwell Use a credential store.
For Git 2.11+ on OS X and Linux, use Git's built in credential store:
git config --global credential.helper libsecret
For msysgit 1.7.9+ on Windows:
git config --global credential.helper wincred
For Git 1.7.9+ on OS X use:
git config --global credential.helper osxkeychain
git: 'credential-gnome-keyring' is not a git command. See 'git --help'.
–
Helicon 2.11
and then using git config --global credential.helper libsecret
it appears that gnome-keyring is deprecated stackoverflow.com/questions/13385690/… –
Jotun printf "protocol=https\nhost=git.mycompany.com\n" | git credential-manager get
(more details here). You should always use a personal access token with this, and of course use 2FA on your GitHub account. –
Barnsley store
to store in a file on your local disk, which is available on all platforms, but less secure." Also, the CredentialManager is available for both MacOS and Linux now. –
Soulsearching There's an easy, old-fashioned way to store user credentials in an HTTPS URL:
https://user:[email protected]/...
You can change the URL with git remote set-url <remote-repo> <URL>
The obvious downside to that approach is that you have to store the password in plain text. You can still just enter the user name (https://[email protected]/...
) which will at least save you half the hassle.
You might prefer to switch to SSH or to use the GitHub client software.
You can just use
git config credential.helper store
When you enter password next time with pull or push, it will be stored in file .git-credentials as plain text (a bit unsecure, but just put it into a protected folder).
And that's it, as stated on this page:
git config credential.helper manager
instead –
Callista It wasn't immediately obvious to me that I needed to download the helper first! I found the credential.helper download at Atlassian's Permanently authenticating with Git repositories.
Quote:
Follow these steps if you want to use Git with credential caching on OS X:
Download the binary git-credential-osxkeychain.
Run the command below to ensure the binary is executable:
chmod a+x git-credential-osxkeychain
Put it in the directory /usr/local/bin
.
Run the command below:
git config --global credential.helper osxkeychain
On a GNU/Linux setup, a ~/.netrc works quite well too:
$ cat ~/.netrc
machine github.com login lot105 password howsyafather
It might depend on which network libraries Git is using for HTTPS transport.
chmod 0600 ~/.netrc
. –
Sirmons Simply include the login credentials as part of the URL:
git remote rm origin
git remote add origin https://username:[email protected]/path/to/repo.git
Note: I do not recommend this method, but if you are in rush and nothing else works, you can use this method.
You can use the Git Credential Manager (GCM) plugin. It is currently maintained by GitHub. The nice thing is that it saves the password in the Windows Credential Store, not as plain text.
There is an installer on the releases page of the project. This will also install the official version of Git for Windows with the credential manager built-in. It allows two-factor authentication for GitHub (and other servers). And has a graphical interface for initially logging in.
For Cygwin users (or users already using the official Git for Windows), you might prefer the manual install. Download the zip package from the releases page. Extract the package, and then run the install.cmd
file. This will install to your ~/bin
folder. (Be sure your ~/bin
directory is in your PATH.) You then configure it using this command:
git config --global credential.helper manager
Git will then run the git-credential-manager.exe
when authenticating to any server.
printf "protocol=https\nhost=git.mycompany.com\n" | git credential-manager get
(more details here). You should always use a personal access token with this, and of course use 2FA on your GitHub account. –
Barnsley If you don't want to store your password in plaintext like Mark said, you can use a different GitHub URL for fetching than you do for pushing. In your configuration file, under [remote "origin"]
:
url = git://github.com/you/projectName.git
pushurl = [email protected]:you/projectName.git
It will still ask for a password when you push, but not when you fetch, at least for open source projects.
You can create your own personal API token (OAuth) and use it the same way as you would use your normal credentials (at: /settings/tokens
). For example:
git remote add fork https://[email protected]/foo/bar
git push fork
.netrc
Another method is to configure your user/password in ~/.netrc
(_netrc
on Windows), e.g.
machine github.com
login USERNAME
password PASSWORD
For HTTPS, add the extra line:
protocol https
To cache your GitHub password in Git when using HTTPS, you can use a credential helper to tell Git to remember your GitHub username and password every time it talks to GitHub.
git config --global credential.helper osxkeychain
(osxkeychain helper
is required),git config --global credential.helper wincred
git config --global credential.helper cache
Related:
You can use credential helpers.
git config --global credential.helper 'cache --timeout=x'
where x
is the number of seconds.
store
, cache
and other common things are listed and explained? –
Hyo After you clone repository repo
, you can edit repo/.git/config
and add some configuration like below:
[user]
name = you_name
password = you_password
[credential]
helper = store
Then you won't be asked for username
and password
again.
helper = manager
(but I'm asked for username+repo for the first push). –
Silberman I know this is not a secure solution, but sometimes you need just a simple solution - without installing anything else. And since helper = store did not work for me, I created a dummy helper:
Create a script and put it in your users bin folder, here named credfake, this script will provide your username and your password:
#!/bin/bash
while read line
do
echo "$line"
done < "/dev/stdin"
echo username=mahuser
echo password=MahSecret12345
make it executable:
chmod u+x /home/mahuser/bin/credfake
then configure it in git:
git config --global credential.helper /home/mahuser/bin/credfake
(or use it without --global for the one repo only)
and - voilá - git will use this user + password.
An authentication token should be used instead of the account password. Go to GitHub settings/applications and then create a personal access token. The token can be used the same way a password is used.
The token is intended to allow users not use the account password for project work. Only use the password when doing administration work, like creating new tokens or revoke old tokens.
Instead of a token or password that grants a user whole access to a GitHub account, a project specific deployment key can be used to grant access to a single project repository. A Git project can be configured to use this different key in the following steps when you still can access other Git accounts or projects with your normal credential:
Host
, IdentityFile
for the deployment key, maybe the UserKnownHostsFile
, and maybe the User
(though I think you don't need it).ssh -F /path/to/your/config $*
GIT_SSH=/path/to/your/wrapper
in front of your normal Git command. Here the git remote
(origin) must use the [email protected]:user/project.git
format.It is better to use credentials for security, but you can keep it for some time using the cache:
git config --global credential.helper cache
git config credential.helper 'cache --timeout=3600'
Your credentials will be saved for 3600 seconds.
windowsservercore
)? –
Aksoyn Usually you have a remote URL, something like this,
git remote -v
origin https://gitlab.com/username/Repo.git (fetch)
origin https://gitlab.com/username/Repo.git (push)
If you want to skip username and password while using git push
, try this:
git remote set-url origin https://username:[email protected]/username/Repo.git
I've just added the same URL (with user details including password) to origin.
NOTE: It doesn't work if username is an email Id.
git remote -v
origin https://username:[email protected]/username/Repo.git (fetch)
origin https://username:[email protected]/username/Repo.git (push)
Things are a little different if you're using two-factor authentication as I am. Since I didn't find a good answer elsewhere, I'll stick one here so that maybe I can find it later.
If you're using two-factor authentication, then specifying username/password won't even work - you get access denied. But you can use an application access token and use Git's credential helper to cache that for you. Here are the pertinent links:
And I don't remember where I saw this, but when you're asked for your username - that's where you stick the application access token. Then leave the password blank. It worked on my Mac.
As of 2021, there is a secure user-friendly cross-platform solution for HTTPS remotes. No more typing passwords! No more SSH keys! No more personal access tokens!
Install Git Credential Manager developed by GitHub (downloads). It supports passwordless OAuth authentication to GitHub, BitBucket, Azure and GitLab. This means you can enable two-factor authentication on GitHub and the other platforms, greatly improving the security of your accounts.
When you push, you are offered a choice of authentication methods:
> git push
Select an authentication method for 'https://github.com/':
1. Web browser (default)
2. Device code
3. Personal access token
option (enter for default): 1
info: please complete authentication in your browser...
On Linux, a tiny bit of setup is required. The following caches credentials in memory for 20 hours, so you have to authenticate at most once per day.
git-credential-manager-core configure
git config --global credential.credentialStore cache
git config --global credential.cacheoptions=--timeout 72000
Power users familiar with gnome-keyring or KWallet may prefer to change the credential store to libsecret.
Cosmetic configuration: Since I always choose 'web browser' at the prompt above, I set a gitHubAuthModes preference to skip the choice. Recent versions of GCM include a GUI that adds an extra click to the authtentication flow, I disable that.
git config --global credential.gitHubAuthModes browser
git config --global credential.guiPrompt false
This works for me I'm using Windows 10
git config --global credential.helper wincred
You also edit the bashrc file and add a script in it.
This would ask for your password once when you start Git and then remembers it until you log off.
SSH_ENV=$HOME/.ssh/environment
# Start the ssh-agent
function start_agent {
echo "Initializing new SSH agent..."
# Spawn ssh-agent
/usr/bin/ssh-agent | sed 's/^echo/#echo/' > "${SSH_ENV}"
echo succeeded
chmod 600 "${SSH_ENV}"
. "${SSH_ENV}" > /dev/null
/usr/bin/ssh-add
}
if [ -f "${SSH_ENV}" ]; then
. "${SSH_ENV}" > /dev/null
ps -ef | grep ${SSH_AGENT_PID} | grep ssh-agent$ > /dev/null || {
start_agent;
}
else
start_agent;
fi
I got my answer from gitcredentials(7) Manual Page. For my case, I don't have credential-cache in my Windows installation; I use credential-store.
After I use credential-store, the username/password are stored in [user folder]/.git-credentials file. To remove the username/password, just delete the content of the file.
git config --global credential.helper wincred
this store the password permanently. –
Kiyokokiyoshi The composer documentation mentions that you can prevent it from using the GitHub API, so that it acts like git clone
:
If you set the
no-api
key totrue
on a GitHub repository it will clone the repository as it would with any other Git repository instead of using the GitHub API. But unlike using thegit
driver directly, composer will still attempt to use GitHub's zip files.
So the section would look like this:
"repositories": [
{
"type": "vcs",
"no-api": true,
"url": "https://github.com/your/repo"
}
],
Keep in mind that the API is there for a reason. So it this should be a method of last resort regarding the increased load on github.com.
Caching credentials locally using Git Credential Manager (GCM) on Ubuntu, tested on Ubuntu 20.04 and 18.04, but should work on other Linux distros.
curl -LO https://raw.githubusercontent.com/GitCredentialManager/git-credential-manager/main/src/linux/Packaging.Linux/install-from-source.sh
sh ./install-from-source.sh
git-credential-manager-core configure
git config --global credential.credentialStore cache
git config --global credential.cacheoptions "--timeout 72000"
sudo rm -rf git-credential-manager/
sudo rm install-from-source.sh
git fetch
Device code
I also had that problem on MacOS, and the following command worked for me:
rm -rf ~/.git-credentials
That is a forced method to really remove all git credentials. And next time I used the push
command, voilà: I am prompted for a username and password (or token).
Two-factor authentication has changed how users authenticate to websites, but Git still assumes users can type a password from memory.
Introducing git-credential-oauth: a Git credential helper that securely authenticates to GitHub, GitLab, BitBucket and other forges using OAuth.
No more passwords! No more personal access tokens! No more SSH keys!
The first time you push, the helper will open a browser window to authenticate. Subsequent pushes within the cache timeout require no interaction.
Install from https://github.com/hickford/git-credential-oauth/releases/
Configure with:
git config --global --unset-all credential.helper
git config --global --add credential.helper "cache --timeout 7200" # two hours
git config --global --add credential.helper oauth
If you are using osxkeychain
and had a token expire and want to update it, follow these steps:
Run in terminal, then press enter twice.
git credential-osxkeychain erase
host=github.com
protocol=https
Now you should be prompted for a username/password. However sometimes it seems this does not 'take' and you have to keep re-entering.
If so, restart your computer. Now the next time you run a git command and enter your username/password, it will be saved.
© 2022 - 2024 — McMap. All rights reserved.
_netrc
file containing your credentials. See my answer below. I found that safer that thegit-credential-winstore.exe
(memory cache) which is a bit buggy on Windows. – Callista