Skip to main content

Troubleshooting

Create an SSH agent diagnostics report​

If you're experiencing issues with how the SSH agent handles your SSH requests, you can send us an SSH diagnostics report so we can help resolve the problem.

You must use a beta or nightly release of the 1Password app to create an SSH diagnostics report.

Step 1: Set up SSH diagnostics recording​

To start recording SSH diagnostics, navigate to the 1Password data directory:

From this location, create a new subdirectory called ssh-diagnostics.

SSH diagnostics recording is now enabled.

Step 2: Run some SSH requests​

Run a few SSH requests using your preferred setup and tools to reproduce the issue you're having.

Each SSH request you run will be logged as a pair of JSON files in the ssh-diagnostics directory.

Step 3: Create a ZIP file of your ssh-diagnostics directory​

After you've recorded a few SSH requests that demonstrate the issue, create a ZIP file of your ssh-diagnostics directory.

To stop recording, delete the ssh-diagnostics directory.

Step 4: Remove personally identifiable information (PII) from the diagnostics files​

The files generated during the SSH diagnostics recording may contain PII, like your OS username, Git repo names, and SSH hosts. The 1Password app attempts to redact as much of this data as possible and you'll see things like <redacted:username>, <redacted:git-repo>, and <redacted:host> in the generated JSON files.

However, there could still be some PII contained in your diagnostics files. Make sure to check for any information you don't want to include, like a company name that appears as part of a path, and redact it. Then recreate your ZIP file.

Was this page helpful?