netlify-credential-helper

README

Netlify Git's credential helper

Netlify Git's credential helper is a program compatible with Git Credential Helpers that uses Netlify's API to authenticate a user.

Install

Our preferred way to install this software is by using Netlify's CLI plugins system:

1. Install Netlify CLI if you have not yet: npm install netlify-cli
2. Install Netlify's Large Media plugin: netlify plugins:install netlify-lm
3. Run the LM Setup: netlify lm:setup.

Netlify's Large Media plugin will download the latest version of this sofware for your OS, and configure Git to use it when it's necessary. You don't need to do anything else.

Alternatively, you can also install this credentials helper manually following one of the guides below:

• Install on Debian/Ubuntu
• Install on Fedora/RedHat
• Install on MacOS X
• Install on Windows with Powershell
• Install on Windows with Scoop
• Manual install

After manually installing the helper, you'll need to add the credential definition to you Git config:

[credential]
	helper = netlify
	useHttpPath = true

Install on Debian/Ubuntu

1. Download the deb file from our Releases.

2. Install with dpkg:

sudo dpkg -i git-credential-netlify-linux-amd64.deb

Install on Fedora/RedHat

1. Download the rpm file from our Releases.

2. Install with dpkg:

sudo dnf install git-credential-netlify-linux-amd64.rpm

Install on MacOS X with Homebrew

1. Open a terminal and copy these two commands:

brew tap netlify/git-credential-netlify
brew install git-credential-netlify

Install on Windows with Powershell

1. Start a Powershell session and copy these two commands:

[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
iex (iwr https://github.com/netlify/netlify-credential-helper/raw/master/resources/install.ps1)

Install on Windows with Scoop

1. Start a Powershell session and copy these two commands:

scoop bucket add netlifyctl https://github.com/netlify/scoop-git-credential-netlify
scoop install git-credential-netlify

Manual install

1. Download the relase binary specific for your OS from our Releases.

2. Extract the binary in your PATH.

Usage with Netlify Large Media

When Git requires your authentication token to push large media to your server, it will invoke this binary directly. If you're not logged in in Netlify, Git will give you the option to login. After this first login, this helper will store your authentication token for future usage so you don't have to login again.

Development

Go 1.11 or above is required to make changes in this program.

Use make deps to install dependencies, make test to run tests, and make build to build the binary.

Release

Use make release to build all packages and create a release in GitHub Releases.

License

MIT