linux/ohmyzsh
Watch
1
0
Fork
You've already forked ohmyzsh
 0
mirror of https://github.com/ohmyzsh/ohmyzsh.git synced 2026-08-07 06:08:39 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

docs(ssh-agent): describe override-agent-socket-path option

Browse source
This commit is contained in:
achevsmisle 2026-06-17 10:49:44 +03:00
commit 06c2394544
No known key found for this signature in database
GPG key ID: 918BC2BA80ECB278
1 changed files with 27 additions and 0 deletions
Download patch file Download diff file Expand all files Collapse all files

27
plugins/ssh-agent/README.md
View file

@ -99,6 +99,33 @@ ssh-add -K -c -a /run/user/1000/ssh-auth <identities>
For valid `ssh-add` arguments run `ssh-add --help` or `man ssh-add`.
### `override-agent-socket-path`
If you want to say goodbye to (for example) gnome-keyring, you will need a fixed,
constant path to SSH-agent socket.
By default its name is randomly generated in form of `$TMPDIR/ssh-XXXXXXXXXX/agent.<ppid>`.
To override the `$SSH_AUTH_SOCK` path, use `override-agent-socket-path` style.
```zsh
zstyle :omz:plugins:ssh-agent override-agent-socket-path "/your/custom/path/socket_name"
```
Of course you should double-quote the path itself.
Also there are few builtin default for Linux and MacOS, so you could simply add:
```zsh
zstyle :omz:plugins:ssh-agent override-agent-socket-path
```
These are the defaults:
* Linux:
The default `$SSH_AUTH_SOCK` will be `"/var/run/user/<YOUR_UID>/ssh-agent"`
* MacOS:
The default `$SSH_AUTH_SOCK` will be `$TMPDIR/ssh-agent.socket"` or `/tmp/ssh-agent.socket"` if `$TMPDIR` is not set for some reason.
* On other systems the socket file will be placed in `"$HOME/.ssh/ssh-agent.socket"`
### Powerline 10k specific settings
Powerline10k has an instant prompt setting that doesn't like when this plugin