Skip to main content

Quick Start Guide

Download, install, and run your first query.

Step 1: Download TablePro

Via Homebrew (fastest):
brew install --cask tablepro
Or manually: Download from GitHub Releases:
  • Apple Silicon (M1+): TablePro-arm64.dmg
  • Intel: TablePro-x86_64.dmg

Step 2: Install TablePro

  1. Open the DMG file
  2. Drag TablePro to Applications
  3. Eject the DMG
  4. Launch TablePro
Installation dialog

Step 3: Create Your First Connection

Click New Connection and fill in your database details. Common examples: MySQL: Host localhost, port 3306, username/password PostgreSQL: Host localhost, port 5432, username/password SQLite: Browse to .sqlite or .db file (no auth required) MongoDB: Host localhost, port 27017, optional username/password
MySQL connection form

Step 4: Test and Connect

  1. Click Test Connection to verify your settings
  2. A green checkmark confirms the connection works
  3. Click Create to save and connect
Connection test success

Step 5: Explore Your Database

The main interface has three panels:
  • Sidebar: Your databases and tables
  • SQL Editor: Write and execute SQL queries
  • Data Grid: View and edit query results
Main interface

Try Your First Query

  1. Click on a table in the sidebar to view its contents
  2. Or type a query in the SQL editor:
SELECT * FROM users LIMIT 10;
  1. Press Cmd+Enter to execute the query
  2. View the results in the data grid below

What’s Next

Explore connections, SSH tunneling, keyboard shortcuts, or AI features. Need help? Check Installation or open an issue on GitHub.