Using Git Credential Manager (GCM) on Windows inside WSL
This guide shows how to use the Git Credential Manager (GCM) installed on Windows to handle Git credentials securely from within WSL (Windows Subsystem for Linux).
🛠️ Prerequisites
- Scoop installed on Windows
- Git Credential Manager installed via Scoop:
scoop install git
scoop install git-credential-manager
- Git installed in WSL (e.g., Ubuntu):
sudo apt update
sudo apt install git
🔗 Configure WSL Git to Use Windows GCM
-
Create a Git configuration that tells Git in WSL to use the Windows GCM executable:
git config --global credential.helper "/mnt/c/Users/<YourUsername>/scoop/shims/git-credential-manager.exe"
Replace
<YourUsername>
with your actual Windows username. If unsure, runcmd.exe /c "echo %USERNAME%"
from WSL. -
Set Git to use the correct credential store (optional, usually auto-detected by GCM):
git-credential-manager configure
-
Verify GCM is being used:
git credential-manager diagnose
-
Test by cloning or pushing to a private repo:
git clone https://github.com/your-private/repo.git
When prompted, authenticate via the browser or your credential store.
✅ Notes
- This setup allows you to share credentials between Windows Git and WSL Git.
- GCM securely stores credentials in the Windows credential manager.
- You can still use SSH for other Git operations if desired.
🔐 Troubleshooting
- Ensure WSL has access to the Windows file system (
/mnt/c/...
). - Make sure GCM is updated with
scoop update git-credential-manager
.