> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tablepro.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Switching to TablePro

> Move your connections from TablePlus, Sequel Ace, DBeaver, DataGrip, Beekeeper Studio or Navicat, what comes across, what does not, and how to get your shortcuts back

Most of a migration is one dialog. **File > Import from Other App…** reads the connections your current client already has, including groups and folders, and the source app does not need to be running.

This page covers the rest: what does not come across, and what to do about it.

## Import your connections

<Steps>
  <Step title="Open the importer">
    **File > Import from Other App…**
  </Step>

  <Step title="Pick your current client">
    TablePlus, Sequel Ace, DBeaver, DataGrip and Beekeeper Studio are read in place. Navicat is the exception: export first with **File > Export Connections** in Navicat, with **Export Password** turned on, then point TablePro at the `.ncx` file.
  </Step>

  <Step title="Review and import">
    Deselect anything you do not want, resolve duplicates, click **Import**.
  </Step>

  <Step title="Open one before you delete the old app">
    Connect to a connection that had a password. That is the only check that proves the credential came across, and deleting the source app is the one step you cannot undo.
  </Step>
</Steps>

<Frame caption="Pick the client you're coming from">
  <img className="block dark:hidden" src="https://mintcdn.com/ngquct/tWJtW3mZjc2I6e31/images/import-from-app-picker.png?fit=max&auto=format&n=tWJtW3mZjc2I6e31&q=85&s=c19468f6b76a798c338b216a1f2b5215" alt="Import from other app, source picker" width="1400" height="964" data-path="images/import-from-app-picker.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/ngquct/tWJtW3mZjc2I6e31/images/import-from-app-picker-dark.png?fit=max&auto=format&n=tWJtW3mZjc2I6e31&q=85&s=f8d4fc76faa10e52b2b720402b2cab9a" alt="Import from other app, source picker" width="1400" height="964" data-path="images/import-from-app-picker-dark.png" />
</Frame>

<Frame caption="Review before anything is saved">
  <img className="block dark:hidden" src="https://mintcdn.com/ngquct/lzfBqqxeRQWdtyIw/images/connection-import-preview.png?fit=max&auto=format&n=lzfBqqxeRQWdtyIw&q=85&s=7c667fa82acc3acb65017256c69a3dba" alt="Import preview listing the connections found" width="1400" height="900" data-path="images/connection-import-preview.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/ngquct/lzfBqqxeRQWdtyIw/images/connection-import-preview-dark.png?fit=max&auto=format&n=lzfBqqxeRQWdtyIw&q=85&s=96abfd414b985a38ed25b5a6f7032ab6" alt="Import preview listing the connections found" width="1400" height="900" data-path="images/connection-import-preview-dark.png" />
</Frame>

SSH tunnel and SSL settings come across with the connection. Which engines each source carries, and the quirks of each one, are in [Connection Sharing](/features/connection-sharing).

## About passwords

| Where your old client keeps them                            | What the import does                                                                                        |
| ----------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| Its own encrypted store: DBeaver, Beekeeper Studio, Navicat | Decrypts it and runs start to finish with nothing to click                                                  |
| The macOS Keychain: TablePlus, Sequel Ace, DataGrip         | macOS asks permission once per item. Choose **Always Allow** rather than **Allow** and the run stops asking |

A DataGrip project protected by a master password cannot be read at all. Import those connections and set their passwords in TablePro.

## What does not come across

| Not imported                                    | What to do                                                                                                                                                                                                                                                     |
| ----------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Saved queries and snippets                      | Re-save the ones you actually use as [Favorites](/features/favorites) with `Cmd+D`. To keep a whole folder of `.sql` files in sync instead, including one tracked in git, [Linked Folders](/features/connection-sharing) does that and needs a Starter license |
| Query history                                   | Starts fresh. TablePro records history per connection from the first query you run, searchable with `Cmd+Y`                                                                                                                                                    |
| Column widths, sort order and per-table filters | Rebuilt as you browse. TablePro saves these per table on its own                                                                                                                                                                                               |
| Keyboard shortcuts                              | See the next section                                                                                                                                                                                                                                           |

## Getting your shortcuts back

TablePro follows macOS conventions, so a good number of chords already match whatever you were using: `Cmd+N`, `Cmd+W`, `Cmd+S`, `Cmd+O`, `Cmd+Q`, `Cmd+F`, and `Cmd+Enter` to run a query.

Where yours differ, rebind them in **Settings > Keyboard** (`Cmd+,`). Record the chord you are used to and TablePro warns you if something else already claims it.

<Frame caption="Settings > Keyboard, where every rebindable shortcut lives">
  <img className="block dark:hidden" src="https://mintcdn.com/ngquct/2-Ctjr-pLlkQ2uWh/images/settings-keyboard.png?fit=max&auto=format&n=2-Ctjr-pLlkQ2uWh&q=85&s=6304a5599de65670168d025be2998ddd" alt="Keyboard settings with the shortcut recorder" width="1442" height="1178" data-path="images/settings-keyboard.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/ngquct/2-Ctjr-pLlkQ2uWh/images/settings-keyboard-dark.png?fit=max&auto=format&n=2-Ctjr-pLlkQ2uWh&q=85&s=687d8630d16c85e012d1ab4df7091fed" alt="Keyboard settings with the shortcut recorder" width="1444" height="1180" data-path="images/settings-keyboard-dark.png" />
</Frame>

Set these up on your first day:

| Job                                                | TablePro          |
| -------------------------------------------------- | ----------------- |
| Run the statement under the cursor                 | `Cmd+Enter`       |
| Run every statement                                | `Cmd+Shift+Enter` |
| Jump to any table, database or saved query by name | `Cmd+Shift+O`     |
| Switch database                                    | `Cmd+K`           |
| Query history                                      | `Cmd+Y`           |
| Cancel a running query                             | `Cmd+.`           |
| Format the query                                   | `Cmd+Shift+L`     |
| Explain the query                                  | `Cmd+Option+E`    |
| Save the query as a favorite                       | `Cmd+D`           |

A few cannot be reassigned, so learn them rather than fight them: editor built-ins such as `Cmd+/` for comment, `Cmd+[` and `Cmd+]` for indent, tab selection `Cmd+1` through `Cmd+9`, text size `Cmd+=` and `Cmd+-`, and `Cmd+F` for find. The recorder tells you when you hit one.

If you use Vim bindings, turn on [Vim Mode](/features/vim-mode) in **Settings > Editor** and most of this section stops mattering.

The full list is in [Keyboard Shortcuts](/features/keyboard-shortcuts).

## Coming from a client TablePro cannot import

Two other routes exist.

**A connection URL.** **Add from Existing > Import from URL** takes a `postgres://`, `mysql://` or similar URL and fills in the form. Fastest path when you only have a handful of connections.

<Frame caption="Import from URL">
  <img className="block dark:hidden" src="https://mintcdn.com/ngquct/4ei5KGhInZes6i6b/images/import-from-url.png?fit=max&auto=format&n=4ei5KGhInZes6i6b&q=85&s=3d95a370c1e284be0f93c7a9f510a176" alt="Import a connection from a database URL" width="1400" height="964" data-path="images/import-from-url.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/ngquct/4ei5KGhInZes6i6b/images/import-from-url-dark.png?fit=max&auto=format&n=4ei5KGhInZes6i6b&q=85&s=7156202a7d75002ff8ede53bd4e5ceeb" alt="Import a connection from a database URL" width="1400" height="964" data-path="images/import-from-url-dark.png" />
</Frame>

**A project folder.** [Open Project Folder](/features/project-folder-import) reads the database settings out of a project's config files, so a repository with a `.env`, `docker-compose.yml` or framework config becomes a connection without you typing a host.

## If your database is not supported yet

Five drivers ship inside the app and cover nine databases. Another 17 come from the registry and
install on the first connection that needs them. See [Plugins & Themes](/features/plugins).

A database missing from the connection form may still be one click away in **Settings > Plugins > Browse**.

<Frame caption="Settings > Plugins > Browse">
  <img className="block dark:hidden" src="https://mintcdn.com/ngquct/2-Ctjr-pLlkQ2uWh/images/settings-plugins-browse.png?fit=max&auto=format&n=2-Ctjr-pLlkQ2uWh&q=85&s=8c4d06826cd03b22bd7b65664bb42119" alt="Plugin registry browser" width="1442" height="1178" data-path="images/settings-plugins-browse.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/ngquct/2-Ctjr-pLlkQ2uWh/images/settings-plugins-browse-dark.png?fit=max&auto=format&n=2-Ctjr-pLlkQ2uWh&q=85&s=dc761e04bf59eaa9c84ad90b92c9a20d" alt="Plugin registry browser" width="1444" height="1180" data-path="images/settings-plugins-browse-dark.png" />
</Frame>

If it is genuinely not there, open a request on [GitHub](https://github.com/TableProApp/TablePro/issues). Driver coverage is tracked in the open, and the [supported database list](/connections) is the current answer.
