Proxy Pageant requests to the Windows OpenSSH agent (from Microsoft), enabling applications that only support Pageant to use openssh.
- Installation
- Usage
- Frequently Asked Questions
- Building
- Bug Reporting, Help & Feature Requests
- Credits
I use the Windows OpenSSH agent as my single ssh key backing. Many solutions exist that do the opposite of this, but I prefer the convenience of Windows OpenSSH agent.
This has been tested on Windows 10 2004 using WSL2. Earlier versions of windows up to 1803 should work too.
WinSSH-Pageant now features an MSI installer for easy upgrading and install/uninstall actions. The installer will:
- Create an appropriate, user-specific autostart entry which you can manager from Task Manager -> Startup tab
- Autostart the application after the installer is finished
Install the Microsoft OpenSSH package, found on their Github. Do not install this using Windows update, that one is quite outdated, and will not work with this software. Follow the instructions for adding OpenSSH to your System PATH.
This application is now available in the offcial Microsoft Package Manager: winget
and is the preferred way to install and upgrade this software.
Action | Command |
---|---|
Install | winget install winssh-pageant |
Upgrade | winget upgrade winssh-pageant |
Download the latest version from the releases page and install it.
For those who do not want an installer, there is also an option to download the compiled, standalone executable. Download the latest .zip and follow the instructions for configuring autostart
Run the executable winssh-pageant.exe
. There are two (optional) flags:
--sshpipe
- name of the windows openssh agent pipe, default is:\\.\pipe\openssh-ssh-agent
--no-pageant-pipe
- disable pageant named pipe proxying
Start Menu Autostart:
-
Open Windows Explorer and navigate to:
%appdata%\Microsoft\Windows\Start Menu\Programs\Startup
-
Inside this folder, Create a shortcut pointing at wherever you put
winssh-pageant.exe
-
If the shortcut is valid, there should be a new
WinSSH-Pageant Bridge
entry found in Task Manager -> Startup
Note: Task Scheduler autostart method is now deprecated and unsupported. It causes possible issues with executable ownership.
You don't. Add your private keys to the standard ssh-agent with the following command:
ssh-add <your key>
clone the repo:
git clone https://github.com/ndbeals/winssh-pageant.git
cd winssh-pageant
go build -ldflags="-w -s -H=windowsgui" -trimpath
The build script build.ps1
accepts numerous, optional flags and two dev dependencies. Install the dev dependencies:
go install github.com/josephspurrier/goversioninfo@latest
go install github.com/mh-cbon/go-msi@latest
Run the build script:
.\build.ps1 -Release
The release flag is optional, though highly recommended, if it is omitted you do not need the two aforementioned dev dependencies.
Your antivirus software may flag this as malware, It's a false positive and a known quirk with go binaries (https://golang.org/doc/faq#virus). The official releases use reproducible builds via -trimpath
. The expected checksums are posted with the release they're meant for, some users may choose to build this project themself and confirm the checksums, sha256sum
.
More information can be found here: #7 (comment)
Please put report all
- Feature Requests
- Bugs
- Help Requests
- General Questsions
Big thanks to https://github.com/benpye/wsl-ssh-pageant, Ben Pye and the other contributors for the examples of interacting with the win32 api, the build script, and help they have given me directly.
- https://github.com/buptczq/WinCryptSSHAgent for a working example of how to open a file mapping another process created.
- @meilon for reporting an internationalization bug and testing the fix for me.