SSH BridgeSSH Bridge
SSH Keys

Managing SSH Keys

SSH keys let you connect to servers without typing a password each time. A key pair has two parts:

  • Private key — stays secret. Add this to SSH Bridge.
  • Public key — safe to share. Upload this to the server you want to connect to.

1. Create an SSH Key Pair

On your computer, create a new Ed25519 key:

ssh-keygen -t ed25519 -f ~/.ssh/sshbridge_n8n -C "sshbridge-n8n"

You can press Enter for no passphrase, or set a passphrase for extra protection.

This creates two files:

  • ~/.ssh/sshbridge_n8n — private key
  • ~/.ssh/sshbridge_n8n.pub — public key

2. Upload the Public Key to Your Server

The server needs your public key in the user's authorized_keys file.

If password login is still enabled, the easiest way is:

ssh-copy-id -i ~/.ssh/sshbridge_n8n.pub [email protected]

Replace root and 203.0.113.10 with your server username and IP address.

If you need to upload it manually, copy the public key:

cat ~/.ssh/sshbridge_n8n.pub

Then append it on the server to:

~/.ssh/authorized_keys

Make sure permissions are correct on the server:

chmod 700 ~/.ssh
chmod 600 ~/.ssh/authorized_keys

3. Test the Key Outside SSH Bridge

Before adding the key to SSH Bridge, verify it works in your terminal:

ssh -i ~/.ssh/sshbridge_n8n [email protected]

If this connects, the server accepts the key.

4. Add the Key to SSH Bridge

  1. Open SSH Keys in the sidebar.
  2. Click Add Key.
  3. Enter a name, for example N8N Key.
  4. Paste the private key from ~/.ssh/sshbridge_n8n into Private Key.
  5. Optionally paste the public key from ~/.ssh/sshbridge_n8n.pub into Public Key.
  6. If the key has a passphrase, enter it in Passphrase.
  7. Click Save.

To copy the private key for pasting:

cat ~/.ssh/sshbridge_n8n

The private key usually starts with:

-----BEGIN OPENSSH PRIVATE KEY-----
[Your long block of encoded key data goes here]
-----END OPENSSH PRIVATE KEY-----

Paste the entire block into SSH Bridge, including the BEGIN OPENSSH PRIVATE KEY and END OPENSSH PRIVATE KEY lines.

Do not upload your private key to the server. Only the public key goes to the server.

5. Use the Key in a Host

  1. Open Hosts.
  2. Create a new host or edit an existing host.
  3. Set Auth Type to SSH Key.
  4. Select the SSH key you added, for example N8N Key.
  5. Confirm the host, port, and username are correct.
  6. Save the host.
  7. Connect to the host from SSH Bridge.

Troubleshooting

  • Permission denied: The public key may not be in the correct user's authorized_keys file.
  • Wrong username: A key added for root will not work for another user unless that user's authorized_keys also contains the public key.
  • Passphrase error: If the key has a passphrase, enter the same passphrase when saving the key in SSH Bridge.
  • Bad key format: Paste the full private key, including the BEGIN and END lines.

Team Shared Keys

If you're part of a team, shared SSH keys appear in your keys list with a team badge. These are read-only and managed by the team owner or admin.

← TroubleshootingSFTP Browser→