> ## Documentation Index
> Fetch the complete documentation index at: https://ngquct-feat-ai-sql-walkthroughs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# SSH Profiles

> Save SSH tunnel configurations as reusable profiles shared across connections

# SSH Profiles

Define an SSH tunnel config once, then reuse it across multiple connections. A profile stores the server (host, port, username), the authentication method, optional two-factor (TOTP) settings, and jump hosts. For tunnel mechanics (auth methods, TOTP modes, jump hosts, `~/.ssh/config` resolution, troubleshooting), see [SSH Tunneling](/databases/ssh-tunneling).

## Creating a Profile

1. Open any connection's **SSH Tunnel** pane
2. Click **Create New Profile...**
3. Fill in the server and authentication fields
4. Click **Create**

Select the profile from the **Profile** picker in other connections. A **Profile Details** disclosure shows the selected profile's settings. Changes to a profile apply to all connections using it.

<Frame caption="Creating an SSH profile">
  <img className="block dark:hidden" src="https://mintcdn.com/ngquct-feat-ai-sql-walkthroughs/Bj1EoTflf_jG6N_3/images/ssh-profile-create.png?fit=max&auto=format&n=Bj1EoTflf_jG6N_3&q=85&s=0a3e4f6a1414bb4a3ed7bb6de0c1f050" alt="Creating an SSH profile" width="1560" height="960" data-path="images/ssh-profile-create.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/ngquct-feat-ai-sql-walkthroughs/Bj1EoTflf_jG6N_3/images/ssh-profile-create-dark.png?fit=max&auto=format&n=Bj1EoTflf_jG6N_3&q=85&s=286f9567c7c3ad94cfa73bc50cf529f3" alt="Creating an SSH profile" width="1560" height="960" data-path="images/ssh-profile-create-dark.png" />
</Frame>

To convert an existing inline SSH config into a profile, click **Save Current as Profile...**.

## Profiles vs Inline Config

Each connection can use either a shared profile or an inline (one-off) SSH config. Inline configs are stored with the connection and don't affect other connections. Profiles are stored globally and shared.

Use a profile when multiple connections go through the same bastion host. Use inline for a one-off tunnel specific to a single connection.

## Editing and Deleting

Select a profile and click **Edit Profile...** to modify it. **Delete Profile** is at the bottom of the editor.

## Testing a Profile

Click **Test Connection** in the profile editor to verify SSH settings without connecting to a database. TablePro performs the SSH handshake, verifies the host key, and authenticates. Green checkmark on success; error dialog on failure. If the server asks for a verification code or another interactive response, the same prompt you'd see on Connect appears during the test.

## iCloud Sync

SSH profiles sync across Macs when iCloud Sync is enabled with the **SSH Profiles** toggle on in **Settings > Account**. Passwords, key passphrases, and TOTP secrets stay in the local Keychain by default. Turning on the **Passwords** toggle (nested under **Connections**) syncs newly saved credentials via iCloud Keychain; re-save an existing password to include it.