README

git-credentials-envvar

Enables git to use credentials provided by environment variables. Useful for single-use environments, e.g. containerised utilities.

Installation

Requirements

Node.js (it is written in javascript)
NPM (for quick installation, otherwise clone the repo, mark cli.js as executable and symlink to somewhere in your $PATH)

Install the binary:

gt; npm install -g git-credentials-envvar

Set GIT to use the credential helper:

gt; git config --global credential.helper envvar

Usage:

The git-credentials-envar credential helper will tell GIT to use the username and password specified in the environment variables GITCREDENTIALUSERNAME and GITCREDENTIALPASSWORD.

Therefore these variables can be specfied across a whole system, or for a specific git command. See the following examples:

System wide credentials

Git will use the same credentials for every host on every git command

gt; export GITCREDENTIALUSERNAME=myuser
gt; export GITCREDENTIALPASSWORD=mypass
gt; git clone http://mygithost.com/repo.git

Command-specific credentials

gt; GITCREDENTIALUSERNAME=myuser GITCREDENTIALPASSWORD=mypass git clone http://mygithost.com/repo.git

If the credential-helper does not find these environment variables, it will print a warning message, and prompt the user for a username and password:

Could not find requried environment variable GITCREDENTIALUSERNAME and/or GITCREDENTIALPASSWORD
Username for 'https://mygithost.com':

Testing

Once the credential-helper is installed, following the Installation instructions above, you can test the results by using the git credential fill command:

gt; git credential fill
protocol=https
host=mygithost.com

Press enter to leave a blank line, the credential-helper should then output:

gt; git credential fill
protocol=https
host=mygithost.com

protocol=https
host=mygithost.com
username=myuser
password=mypass

git-credential-envvar

Usage no npm install needed!