Skip to content

docs: update WSL docs to use correct GfW install paths #2460

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
mjcheetham merged 1 commit into from
Oct 1, 2026
Merged

docs: update WSL docs to use correct GfW install paths #2460

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 31 additions & 5 deletions docs/wsl.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -21,20 +21,46 @@ Start by installing the [latest Git for Windows ⬇️][latest-git-for-windows]
_Inside your WSL installation_, run the following command to set GCM as the Git
credential helper:

> [!IMPORTANT]
> The exact location of git-credential-manager.exe may be different in your
> installation of Git for Windows depending on the version you have installed.
> Please check and confirm the actual installation path before proceeding.

### Git for Windows (x64 / x86_64 / "64-bit")

The latest versions of Git for Windows for x64 (v2.56.0 and later) use the
`ucrt64` toolchain and installation path:

```shell
git config --global credential.helper "/mnt/c/Program\ Files/Git/ucrt64/bin/git-credential-manager.exe"
```

Older versions of Git for Windows for x64 (v2.55.x and earlier) use the
`mingw64` toolchain and installation path:

```shell
git config --global credential.helper "/mnt/c/Program\ Files/Git/mingw64/bin/git-credential-manager.exe"
```

> **Note:** the location of git-credential-manager.exe may be different in your
installation of Git for Windows.
### Git for Windows (ARM64)

If you intend to use Azure DevOps you must _also_ set the following Git
configuration _inside of your WSL installation_.
All known versions of Git for Windows for ARM64 use the `clangarm64` toolchain
and installation path:

```shell
git config --global credential.https://dev.azure.com.useHttpPath true
git config --global credential.helper "/mnt/c/Program\ Files/Git/clangarm64/bin/git-credential-manager.exe"
```

## Azure DevOps Additional Configuration

> [!IMPORTANT]
> If you intend to use Azure DevOps you must _also_ set the following Git
> configuration _inside of your WSL installation_.
>
> ```shell
> git config --global credential.https://dev.azure.com.useHttpPath true
> ```

## Configuring WSL without Git for Windows

If you wish to use GCM inside of WSL _without installing Git for Windows_
Expand Down
Loading