Skip to content

Add Windows troubleshooting for SSH agent conflicts. #42822

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

Open
BlackDoubleB wants to merge 3 commits into
base: main
Choose a base branch
from
+15 −1
Open

Add Windows troubleshooting for SSH agent conflicts. #42822

Changes from all commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
1893eaa
Add Windows troubleshooting for SSH agent conflicts
BlackDoubleB Feb 7, 2026
4659832
Merge branch 'main' into patch-1
BlackDoubleB Feb 7, 2026
e9a25b9
Trigger CI
BlackDoubleB Feb 7, 2026
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
16 changes: 15 additions & 1 deletion ...g-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -162,6 +162,18 @@ Before adding a new SSH key to the ssh-agent to manage your keys, you should hav
```powershell
ssh-add c:/Users/YOU/.ssh/id_ed25519
```
> [!TIP]
> **Troubleshooting SSH agent conflicts in Windows**
>
> In Windows environments, the native Windows OpenSSH implementation and the one included with Git for Windows (based on MSYS2/Bash) can coexist.
>
> If you configure and save your passphrases in the Windows agent using PowerShell, Git may still prompt you for your passphrase during operations like `git push`. This can happen when Git for Windows uses its bundled `ssh.exe` (from MSYS2) instead of the Windows system OpenSSH client, and therefore can't talk to the Windows `ssh-agent` service.
>
> To ensure Git uses the agent where you've stored your credentials, force Git to use the system's SSH binary by running:
>
> ```powershell
> git config --global core.sshCommand "C:/Windows/System32/OpenSSH/ssh.exe"
> ```

{% data reusables.ssh.add-public-key-to-github %}

Expand Down Expand Up @@ -254,5 +266,7 @@ If you are using macOS or Linux, you may need to update your SSH client or insta
> Enter passphrase (empty for no passphrase): [Type a passphrase]
> Enter same passphrase again: [Type passphrase again]
```

{% data reusables.ssh.add-public-key-to-github %}


Loading