Skip to main content

​
Quick Start Guide

This guide will help you download TablePro, install it, and connect to your first database.

​
Step 1: Download TablePro

  1. Visit the GitHub Releases page
  2. Download the DMG file for your Mac:
    • Apple Silicon (M1/M2/M3/M4/M5): TablePro-arm64.dmg
    • Intel: TablePro-x86_64.dmg
Not sure which chip your Mac has? Click the Apple menu and select About This Mac. Look for “Chip” (Apple Silicon) or “Processor” (Intel).

​
Step 2: Install TablePro

  1. Open the downloaded DMG file
  2. Drag TablePro to your Applications folder
  3. Eject the DMG
  4. Open TablePro from your Applications folder
Installation dialog
On first launch, macOS may show a security warning since TablePro is not signed with an Apple Developer certificate. To open it:
  1. Right-click (or Control-click) on TablePro in Applications
  2. Select Open from the context menu
  3. Click Open in the dialog that appears
You only need to do this once.

​
Step 3: Create Your First Connection

When TablePro launches, you’ll see the Welcome screen. Let’s create a new database connection.

​
For MySQL/MariaDB

  1. Click New Connection
  2. Select MySQL or MariaDB as the database type
  3. Fill in the connection details:
    • Name: A friendly name for this connection (e.g., “Local MySQL”)
    • Host: localhost (or your server address)
    • Port: 3306 (default)
    • Username: Your database username (e.g., root)
    • Password: Your database password
    • Database: (Optional) Default database to connect to
MySQL connection form

​
For PostgreSQL

  1. Click New Connection
  2. Select PostgreSQL as the database type
  3. Fill in the connection details:
    • Name: A friendly name (e.g., “Local PostgreSQL”)
    • Host: localhost (or your server address)
    • Port: 5432 (default)
    • Username: Your database username (e.g., postgres)
    • Password: Your database password
    • Database: The database name to connect to

​
For SQLite

  1. Click New Connection
  2. Select SQLite as the database type
  3. Click Browse to select your SQLite database file
  4. Give your connection a name
SQLite databases don’t require authentication - just select the .sqlite or .db file on your Mac.

​
Step 4: Test and Connect

  1. Click Test Connection to verify your settings
  2. If successful, you’ll see a green checkmark
  3. Click Create to save the connection and connect
Connection test success

​
Step 5: Explore Your Database

Once connected, you’ll see the main interface with:
  • 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

​
Next Steps

Congratulations! You’ve successfully set up TablePro. Here’s what to explore next:

Database Connections

Learn more about managing and organizing your connections.

SQL Editor

Master the SQL editor with syntax highlighting and autocomplete.

SSH Tunneling

Connect securely to remote databases through SSH.

Keyboard Shortcuts

Speed up your workflow with keyboard shortcuts.

​
Need Help?

If you encounter any issues: