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.
Connection Sharing
Export connections to a .tablepro file and share with your team. Passwords stay in your Keychain.
Export
Right-click a connection > Export Connection…. Select multiple first to export together. Or use File > Export Connections… for all.
Exported: host, port, username, type, SSH/SSL config, color, tag, group, Safe Mode. Not exported: passwords, key passphrases, TOTP secrets.
Import
- File > Import Connections…
- Right-click empty area > Import Connections…
- Double-click a
.tablepro file
- Drag onto TablePro
A preview shows each connection before importing:
| Badge | Meaning |
|---|
| Green checkmark | Ready |
| Yellow triangle | SSH key or cert not found |
| ”duplicate” tag | Already exists |
Import from Other Apps
Bring your connections over from TablePlus, Sequel Ace, or DBeaver. Passwords can be imported too. The source app doesn’t need to be running.
- File > Import from Other App…
- Pick the source app and click Continue.
- Review the list, uncheck anything you don’t want, then click Import.
Groups and folders carry over.
| App | Databases | Passwords |
|---|
| TablePlus | MySQL, PostgreSQL, MongoDB, SQLite, Redis, and more | From Keychain |
| Sequel Ace | MySQL | From Keychain |
| DBeaver | MySQL, PostgreSQL, SQLite, SQL Server, Oracle, and more | Decrypted from config file |
Share via Link
Two link forms ship with TablePro. Pick the one that matches what you want to share.
Copy as Import Link
Right-click > Copy as Import Link. Produces a tablepro://import?... URL with host, port, type, and username (no password). Paste in Slack, a wiki, or a README. The recipient opens the link, reviews the prefilled form, adds their own password, and saves.
tablepro://import?name=Staging&host=db.example.com&port=5432&type=PostgreSQL&username=admin
Copy Connection Deep Link
Right-click > Copy Connection Deep Link. Produces a tablepro://connect/<uuid> URL that opens the connection you already have saved. The link refers to your local connection record by UUID, so it only works on a Mac that already has the same connection saved (for example, your other Mac with iCloud Sync, or a teammate who imported the connection). Use this form for bookmarks, Raycast Quicklinks, or shell aliases.
tablepro://connect/9f1f0c3e-2e3d-4b14-9c3a-1d2f4ad1f6f1
Encrypted Export Pro
Include passwords in the export, protected by a passphrase (AES-256-GCM).
- Right-click > Export…
- Check Include Credentials
- Enter passphrase (8+ characters), confirm
- Export…
When importing, TablePro prompts for the passphrase.
Linked Folders Pro
Watch a shared directory for .tablepro files. Connections appear read-only in the sidebar. Each person enters their own password.
Settings (Cmd+,) > Account > Linked Folders > Add Folder…
Works with Git repos, Dropbox, network drives.
Environment Variables Pro
Use $VAR and ${VAR} in .tablepro files. Resolved at connection time.
{
"host": "${DB_HOST}",
"username": "$DB_USER"
}
.env files, 1Password CLI (op run), direnv.
JSON. Required fields: name, host, type.
{
"formatVersion": 1,
"connections": [
{
"name": "Production",
"host": "db.example.com",
"port": 3306,
"type": "MySQL",
"username": "deploy",
"tagName": "production"
}
],
"groups": [
{ "name": "Backend", "color": "Blue" },
{ "name": "Staging", "color": "Green", "parentGroupName": "Backend" }
],
"tags": [{ "name": "production", "color": "Red" }]
}
parentGroupName to preserve hierarchy. Paths use ~/ for portability.
Sharing vs iCloud Sync
| Sharing | iCloud Sync |
|---|
| For | Team | Your Macs |
| How | Files, links | CloudKit |
| Passwords | Per-user (encrypted with Pro) | Optional sync |
| Requires | Nothing (Pro for extras) | Pro + iCloud |
