> ## Documentation Index
> Fetch the complete documentation index at: https://ngquct-feat-721-compare-sync.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

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-721-compare-sync/Px1jOVnHwSdgRuFN/images/ssh-profile-create.png?fit=max&auto=format&n=Px1jOVnHwSdgRuFN&q=85&s=d173582857865e1f3bdb13670db2a97b" 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-721-compare-sync/Px1jOVnHwSdgRuFN/images/ssh-profile-create-dark.png?fit=max&auto=format&n=Px1jOVnHwSdgRuFN&q=85&s=9271bbe1ae0c6e6474ae4789bccedfe9" 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. On success the button shows a green checkmark and **Connected** appears next to it. On failure the button shows a red X and the error appears in orange, cut to two lines. 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.