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

# Quick Start

> Download TablePro, install it, and connect to your first database in under 5 minutes

# Quick Start Guide

Download, install, and run your first query.

## Step 1: Download TablePro

Via Homebrew (fastest):

```bash theme={null}
brew install --cask tablepro
```

Or manually: Download from [GitHub Releases](https://github.com/TableProApp/TablePro/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

<Frame caption="Drag TablePro to Applications">
  <img className="block dark:hidden" src="https://mintcdn.com/ngquct/xXCKxj6nL9A5hobN/images/install-dmg.png?fit=max&auto=format&n=xXCKxj6nL9A5hobN&q=85&s=46b1c4615cd0d720a9b24c9ce5302fde" alt="Installation dialog" width="1200" height="800" data-path="images/install-dmg.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/ngquct/xXCKxj6nL9A5hobN/images/install-dmg-dark.png?fit=max&auto=format&n=xXCKxj6nL9A5hobN&q=85&s=456e9e3c7baac4bb736c3277eeb50457" alt="Installation dialog" width="1200" height="800" data-path="images/install-dmg-dark.png" />
</Frame>

## Step 3: Create Your First Connection

The welcome window has a sidebar of saved connections on the left and a detail panel on the right. Search is in the window toolbar; press `Cmd+F` to focus it. The toolbar `+` button starts a new connection, and the folder button creates a connection group.

Each connection shows its tag and group, so you can tell production from staging at a glance. The same labels appear in the connection switcher in the editor toolbar.

First launch ships a bundled Chinook sample database. Open it with one click to try TablePro without setting up a server. Reset the sample from **File > Reset Sample Database** any time.

To make a real connection, click **Create connection** in the empty state (or the toolbar `+`). A chooser sheet appears with every supported database type grouped by category. Pick one and click **Continue**.

<Frame caption="Pick a database type">
  <img className="block dark:hidden" src="https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/database-type-chooser.png?fit=max&auto=format&n=hpeNl6Aughc_P6IP&q=85&s=ad95b8ab115abe89f0dcfb7e300fef4d" alt="Database type chooser" width="1400" height="964" data-path="images/database-type-chooser.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/database-type-chooser-dark.png?fit=max&auto=format&n=hpeNl6Aughc_P6IP&q=85&s=567ba53d6882f7924c6804d35934eaf0" alt="Database type chooser" width="1400" height="964" data-path="images/database-type-chooser-dark.png" />
</Frame>

The connection form opens, pre-filled with sensible defaults. Common examples:

**MySQL**: host `localhost`, port `3306`, username `root`
**PostgreSQL**: host `localhost`, port `5432`, username `postgres`
**SQLite**: browse to a `.sqlite` or `.db` file, no auth needed
**MongoDB**: host `localhost`, port `27017`, optional username/password

<Frame caption="PostgreSQL connection form">
  <img className="block dark:hidden" src="https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-form-general.png?fit=max&auto=format&n=hpeNl6Aughc_P6IP&q=85&s=181421700655bff4aca037d34b251805" alt="Connection form" width="1440" height="1224" data-path="images/connection-form-general.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-form-general-dark.png?fit=max&auto=format&n=hpeNl6Aughc_P6IP&q=85&s=5d88e8271dda9d0fdccf88d4ca1db5cd" alt="Connection form" width="1440" height="1224" data-path="images/connection-form-general-dark.png" />
</Frame>

<Tip>
  Already have a connection URL? Click **Import from URL...** in the chooser footer. TablePro detects the database type and pre-fills the form for you.
</Tip>

## Step 4: Test and Save

The General pane has a **Status** row at the bottom with a Test Connection button. Click it to verify your settings. Once it shows a green checkmark, click **Save & Connect** in the toolbar.

<Frame caption="Test Connection succeeded">
  <img className="block dark:hidden" src="https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-test.png?fit=max&auto=format&n=hpeNl6Aughc_P6IP&q=85&s=d96e6842269c87551c2e6a667710ccf6" alt="Connection test success" width="1440" height="1224" data-path="images/connection-test.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/ngquct/hpeNl6Aughc_P6IP/images/connection-test-dark.png?fit=max&auto=format&n=hpeNl6Aughc_P6IP&q=85&s=95474c209cabbada8287c312a9181a54" alt="Connection test success" width="1440" height="1224" data-path="images/connection-test-dark.png" />
</Frame>

## 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

<Frame caption="TablePro main interface">
  <img className="block dark:hidden" src="https://mintlify.s3.us-west-1.amazonaws.com/ngquct/images/main-interface.png" alt="Main interface" />

  <img className="hidden dark:block" src="https://mintlify.s3.us-west-1.amazonaws.com/ngquct/images/main-interface-dark.png" alt="Main interface" />
</Frame>

### 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:

```sql theme={null}
SELECT * FROM users LIMIT 10;
```

3. Press `Cmd+Enter` to execute the query
4. View the results in the data grid below

## What's Next

Explore [connections](/databases/overview), [SSH tunneling](/databases/ssh-tunneling), [keyboard shortcuts](/features/keyboard-shortcuts), or [AI features](/features/ai-assistant).

Need help? Check [Installation](/installation) or [open an issue](https://github.com/TableProApp/TablePro/issues) on GitHub.