feat: add WSL2 1Password SSH Agent bridge setup and update README with instructions
This commit is contained in:
31
README.md
31
README.md
@@ -103,3 +103,34 @@ To add a new system you should follow these steps:
|
||||
1. Add the relevant files shown in the section above.
|
||||
2. Ensure you've either updated or added the `$HOME/.hostname` file with the hostname of the system.
|
||||
3. Run `dotf update` to ensure the symlinks are properly updated/created.
|
||||
---
|
||||
|
||||
## Using 1Password SSH Agent with WSL2 (Windows 11)
|
||||
|
||||
This setup allows you to use your 1Password-managed SSH keys inside WSL2. The WSL-side steps are automated by Ansible. The following Windows-side steps must be performed manually:
|
||||
|
||||
### Windows-side Setup
|
||||
|
||||
1. **Enable 1Password SSH Agent**
|
||||
- Open the 1Password app on Windows.
|
||||
- Go to **Settings → Developer** and enable **"Use the SSH agent"**.
|
||||
|
||||
2. **Install npiperelay using winget**
|
||||
- Open PowerShell and run the following command:
|
||||
```sh
|
||||
winget install albertony.npiperelay
|
||||
```
|
||||
- This will install the latest maintained fork of npiperelay and add it to your PATH automatically.
|
||||
3. **Restart Windows Terminal**
|
||||
- After completing the above steps, restart your Windows Terminal to ensure all changes take effect.
|
||||
|
||||
4. **Test the SSH Agent in WSL2**
|
||||
- Open your WSL2 terminal and run:
|
||||
```sh
|
||||
ssh-add -l
|
||||
```
|
||||
- If your 1Password keys are listed, the setup is complete.
|
||||
|
||||
#### References
|
||||
- [Using 1Password's SSH Agent with WSL2](https://dev.to/d4vsanchez/use-1password-ssh-agent-in-wsl-2j6m)
|
||||
- [How to change the PATH environment variable in Windows](https://www.wikihow.com/Change-the-PATH-Environment-Variable-on-Windows)
|
||||
|
Reference in New Issue
Block a user