Skip to main content
With no connections saved, the welcome window offers Try Sample Database, a bundled Chinook SQLite file that needs no server and drops you at step 4. Reset it any time from Help > Reset Sample Database….
1

Install TablePro

brew install --cask tablepro, or the DMG from GitHub Releases. See Installation.
2

Create a connection

Click Create Connection… in the welcome window, pick a type in the Choose a Database sheet, then click Continue. A type badged Not Installed downloads its driver before the form opens, with no restart.
Database type chooser

Pick a database type

Already have a connection URL, another client’s connections, or a repository with a .env? Add from Existing takes all three. See Switching to TablePro.
3

Fill in the form, test it, save it

The host pre-fills to localhost and the port to the engine’s default. Username is optional: leave it empty and the database applies its own default. SQLite asks for a .sqlite or .db file instead of a host, with no credentials.
Connection form

PostgreSQL connection form

Click Test Connection in the Status row at the bottom of the General pane. It turns into Connected with a green checkmark. Now click Save & Connect in the toolbar.
Connection test success

Test Connection succeeded

The window switches to the main layout: databases and tables in the sidebar, the open tab in the middle, the inspector on the right.
A failed attempt paints the window with the driver’s own message and a Try Again button instead. Troubleshooting sorts refused from timed out.
4

Run a query

Click a table in the sidebar to browse it. For SQL, press Cmd+T for a query tab, type, and press Cmd+Enter to run the statement under the cursor.
Main interface

A table tab showing the data grid

​
What’s next

Managing connections, SSH tunneling, keyboard shortcuts, and AI features. Anything that goes wrong is worth an issue.