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:
- Install Netlify CLI if you have not yet:
npm install netlify-cli - Install Netlify's Large Media plugin:
netlify plugins:install netlify-lm - 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
Install on Debian/Ubuntu
-
Download the deb file from our Releases.
-
Install with dpkg:
sudo dpkg -i git-credential-netlify-linux-amd64.deb
Install on Fedora/RedHat
-
Download the rpm file from our Releases.
-
Install with dpkg:
sudo dnf install git-credential-netlify-linux-amd64.rpm
Install on MacOS X with Homebrew
- Open a terminal and copy these two commands:
brew tap netlify/git-credential-netlify
brew install git-credential-netlify
Install on Windows with Powershell
- Start a Powershell session and copy these two commands:
[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12
iex (iwr -UseBasicParsing -Uri https://github.com/netlify/netlify-credential-helper/raw/master/resources/install.ps1)
Install on Windows with Scoop
- 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
-
Download the relase binary specific for your OS from our Releases.
-
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.
Directories