Skip to content

Add Windows troubleshooting for SSH agent conflicts.#42822

Merged
Sharra-writes merged 10 commits intogithub:mainfrom
BlackDoubleB:patch-1
Feb 18, 2026
Merged

Add Windows troubleshooting for SSH agent conflicts.#42822
Sharra-writes merged 10 commits intogithub:mainfrom
BlackDoubleB:patch-1

Conversation

@BlackDoubleB
Copy link
Contributor

Add guidance for resolving passphrase prompts caused by Git for Windows using a different SSH client than the Windows ssh-agent.

Why

Users on Windows may configure ssh-agent in PowerShell but still be prompted for a passphrase when using Git operations. This can happen when Git for Windows uses its bundled SSH client, which cannot access the Windows ssh-agent service.

What's being changed

  • Add a Windows TIP explaining the Git for Windows vs Windows OpenSSH mismatch.
  • Include a command to configure Git to use the Windows system OpenSSH client:
    • git config --global core.sshCommand "C:/Windows/System32/OpenSSH/ssh.exe"

Check off the following

  • I have reviewed the technical accuracy of the content in this PR.

Add guidance for resolving passphrase prompts caused by Git for Windows using a different SSH client than the Windows ssh-agent.
@welcome
Copy link

welcome bot commented Feb 7, 2026

Thanks for opening this pull request! A GitHub docs team member should be by to give feedback soon. In the meantime, please check out the contributing guidelines.

@github-actions github-actions bot added the triage Do not begin working on this issue until triaged by the team label Feb 7, 2026
@github-actions
Copy link
Contributor

github-actions bot commented Feb 7, 2026

How to review these changes 👓

Thank you for your contribution. To review these changes, choose one of the following options:

A Hubber will need to deploy your changes internally to review.

Table of review links

Note: Please update the URL for your staging server or codespace.

The table shows the files in the content directory that were changed in this pull request. This helps you review your changes on a staging server. Changes to the data directory are not included in this table.

Source Review Production What Changed
authentication/connecting-to-github-with-ssh/generating-a-new-ssh-key-and-adding-it-to-the-ssh-agent.md fpt
ghec
ghes@ 3.19 3.18 3.17 3.16 3.15 3.14
fpt
ghec
ghes@ 3.19 3.18 3.17 3.16 3.15 3.14

Key: fpt: Free, Pro, Team; ghec: GitHub Enterprise Cloud; ghes: GitHub Enterprise Server

🤖 This comment is automatically generated.

@BlackDoubleB BlackDoubleB changed the title Add Windows troubleshooting for SSH agent conflicts Add Windows troubleshooting for SSH agent conflicts. Feb 7, 2026
@Sharra-writes
Copy link
Contributor

@BlackDoubleB Thanks for opening a PR! Let me check with the rest of the team about this and see what they think.

@Sharra-writes Sharra-writes added authentication Content relating to authentication content This issue or pull request belongs to the Docs Content team and removed triage Do not begin working on this issue until triaged by the team labels Feb 13, 2026
@Sharra-writes
Copy link
Contributor

@BlackDoubleB Theoretically this is something we would accept, but because it contains a code snippet in a code security article, it's going to needs lots of approvals, and it's probably going to take quite a while. I'm going to start looking for the people whose approvals I'll need, but I'm just giving you a heads up that this one is going to be complicated on our end.

@Sharra-writes Sharra-writes added the needs SME This proposal needs review from a subject matter expert label Feb 18, 2026
@github-actions
Copy link
Contributor

Thanks for opening a pull request! We've triaged this issue for technical review by a subject matter expert 👀

@Sharra-writes Sharra-writes added the SME reviewed An SME has reviewed this issue/PR label Feb 18, 2026
@Sharra-writes
Copy link
Contributor

@BlackDoubleB I got lucky and found exactly the person I needed to talk to first try! 🎉 They gave approval, I just need to reformat this to fit our style guide and it should be good to go.

@Sharra-writes Sharra-writes added this pull request to the merge queue Feb 18, 2026
@github-merge-queue github-merge-queue bot removed this pull request from the merge queue due to failed status checks Feb 18, 2026
@Sharra-writes Sharra-writes added this pull request to the merge queue Feb 18, 2026
@github-merge-queue github-merge-queue bot removed this pull request from the merge queue due to failed status checks Feb 18, 2026
@Sharra-writes Sharra-writes added this pull request to the merge queue Feb 18, 2026
Merged via the queue into github:main with commit 977a27d Feb 18, 2026
39 checks passed
@github-actions
Copy link
Contributor

Thanks very much for contributing! Your pull request has been merged 🎉 You should see your changes appear on the site in approximately 24 hours. If you're looking for your next contribution, check out our help wanted issues

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

authentication Content relating to authentication content This issue or pull request belongs to the Docs Content team needs SME This proposal needs review from a subject matter expert SME reviewed An SME has reviewed this issue/PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants

Comments