Skip to main content
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

1

Open the importer

File > Import from Other App…
2

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.
3

Review and import

Deselect anything you do not want, resolve duplicates, click Import.
4

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.
Import from other app, source picker

Pick the client you're coming from

Import preview listing the connections found

Review before anything is saved

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.

About passwords

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

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.
Keyboard settings with the shortcut recorder

Settings > Keyboard, where every rebindable shortcut lives

Set these up on your first day: 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 in Settings > Editor and most of this section stops mattering. The full list is in 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.
Import a connection from a database URL

Import from URL

A project folder. Open Project Folder 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. A database missing from the connection form may still be one click away in Settings > Plugins > Browse.
Plugin registry browser

Settings > Plugins > Browse

If it is genuinely not there, open a request on GitHub. Driver coverage is tracked in the open, and the supported database list is the current answer.