git-credential-manager

# Git Credential Manager

[![Build Status][build-status-badge]][workflow-status]

---

[Git Credential Manager][gcm] (GCM) is a secure
[Git credential helper][git-credential-helper] built on [.NET][dotnet] that runs
on Windows, macOS, and Linux. It aims to provide a consistent and secure
authentication experience, including multi-factor auth, to every major source
control hosting service and platform.

GCM supports (in alphabetical order) [Azure DevOps][azure-devops], Azure DevOps
Server (formerly Team Foundation Server), Bitbucket, GitHub, and GitLab.
Compare to Git's [built-in credential helpers][git-tools-credential-storage]
(Windows: wincred, macOS: osxkeychain, Linux: gnome-keyring/libsecret), which
provide single-factor authentication support for username/password only.

GCM replaces both the .NET Framework-based
[Git Credential Manager for Windows][gcm-for-windows] and the Java-based
[Git Credential Manager for Mac and Linux][gcm-for-mac-and-linux].

## Install

See the [installation instructions][install] for the current version of GCM for
install options for your operating system.

## Current status

Git Credential Manager is currently available for Windows, macOS, and Linux and
works with HTTP(S) remotes.

You can still use Git with SSH - see the specific documentation for your host on
how to set up SSH: [Azure DevOps][azure-devops-ssh], [GitHub][github-ssh],
[Bitbucket][bitbucket-ssh]

Feature|Windows|macOS|Linux¹
-|:-:|:-:|:-:
Installer/uninstaller|✓|✓|✓
Secure platform [credential storage][gcm-credstores]|✓|✓|✓
Entra authentication with [broker support][gcm-broker]|✓|✓|✓
Azure DevOps authentication|✓|✓|✓
GitHub & GHES authentication|✓|✓|✓
Bitbucket Cloud & DC authentication|✓|✓|✓
GitLab authentication|✓|✓|✓
Windows Integrated Authentication (NTLM/Kerberos)|✓|_N/A_|_N/A_
Generic OAuth authentication|✓|✓|✓
Basic HTTP authentication|✓|✓|✓
Network proxies|✓|✓|✓
x64 _(x86_64 / AMD64)_ support|✓|✓²|✓
x86 _(i686)_ support|✓³|_N/A_|✗
ARM64 _(aarch64)_ support|✓|✓|✓
ARM32 _(armhf)_ support|_N/A_|_N/A_|✓³

1. Linux support is limited to the
   [distributions officially supported by .NET][dotnet-os-support].

2. Mac support on Intel-based (x64) devices is best effort.
   Apple announced that macOS 28 will [drop support][apple-intel-support] for
   Intel-based applications.

3. No official builds produced, but local builds should be possible.
   Support is best effort.

## Supported Environments

We aim to support the broadest set of operating systems and distributions,
within reason. We aim to target and update to the latest current .NET LTS
version as they become generally available.

### Windows

GCM supports Windows 10 and later, including Windows Server 2016 and lat