Skip to content

Commit 427adb9

Browse files
committed
add admonition for using keeper when setting up manual ssh agent
1 parent 01c97ac commit 427adb9

File tree

1 file changed

+8
-10
lines changed

1 file changed

+8
-10
lines changed

doc/tools/SSH-keys.md

Lines changed: 8 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -39,22 +39,20 @@ If you want to use Keeper (you'll need the desktop client for this, _not_ the br
3939

4040
This is done by following [this guide](https://docs.keeper.io/en/keeperpam/privileged-access-manager/ssh-agent#activating-the-ssh-agent) with your public key, private key and passphrase filled in.
4141

42-
In `Settings -> Developer`, enable the "SSH Agent" which will add your keys, without needing to enter the passphrases, when the keeper vault is unlocked.
43-
44-
Ignore the section below as you don't need to manually set up an SSH agent.
45-
4642
You may need to [turn the `OpenSSH` agent off](https://docs.keeper.io/en/keeperpam/privileged-access-manager/ssh-agent#windows-note-on-ssh-agent-conflicts) if it's on your machine - see if `ssh-agent` is running in your services in task manager.
4743

48-
### Troubleshooting
49-
50-
#### SSH works and prompts to use passphrase, but git doesn't show the prompt
51-
If `ssh [email protected]` works fine, your SSH key has been added to Github, so that's a good start.
52-
53-
You may need to set the `GIT_SSH` environment variable to wherever your git installation is as git might try and use its own ssh executable which doesn't seem to work with Keeper. `where ssh` will tell you where this is.
44+
### SSH works and prompts to use passphrase, but git doesn't show the prompt
45+
If `ssh [email protected]` works fine, your SSH key has been added to Github and `ssh` is using it.
5446

47+
You may need to set the `GIT_SSH` environment variable to wherever your ssh executable is, as git might try and use its own ssh executable which doesn't seem to work with Keeper. `where ssh` will tell you where this is.
5548

49+
{#manual_ssh_agent}
5650
## Manually Setting up SSH agent
5751

52+
```{note}
53+
Ignore this section if you followed {ref}`the section on setting up keeper as your ssh agent<keeper_ssh>`.
54+
```
55+
5856
In a powershell window, run the following commands:
5957
```powershell
6058
Get-Service ssh-agent | Set-Service -StartupType Automatic

0 commit comments

Comments
 (0)