> ## Documentation Index
> Fetch the complete documentation index at: https://ngquct-feat-ai-sql-walkthroughs.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Connect to your first database and run a query in a few minutes

# Quick Start Guide

Install TablePro, connect to a database, and run your first query.

## Step 1: Install

Install via Homebrew (`brew install --cask tablepro`) or download the DMG from GitHub Releases. See [Installation](/installation).

## Step 2: Create Your First Connection

The welcome window has an actions panel on the left (Create Connection, Import from Other App, Try Sample Database) and your saved connections on the right. The search field, `+` button, and group button sit at the top of the connections panel; press `Cmd+F` to focus search. Each connection shows its tag and group, so you can tell production from staging at a glance.

* **Try Sample Database** opens the bundled Chinook SQLite database, no server needed. Reset it any time from **File > Reset Sample Database...**.
* **Import from Other App...** copies your saved connections from TablePlus, DataGrip, Beekeeper Studio, and other clients.

Click **Create Connection...**. A chooser sheet lists 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-feat-ai-sql-walkthroughs/REI9tfF_TGivM099/images/database-type-chooser.png?fit=max&auto=format&n=REI9tfF_TGivM099&q=85&s=c05a860f58bd157c9231228a7dec3d04" 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-feat-ai-sql-walkthroughs/REI9tfF_TGivM099/images/database-type-chooser-dark.png?fit=max&auto=format&n=REI9tfF_TGivM099&q=85&s=a34ba39c5376106f9eda73b1cc354283" alt="Database type chooser" width="1400" height="964" data-path="images/database-type-chooser-dark.png" />
</Frame>

<Note>
  Databases beyond the bundled drivers (MongoDB, Oracle, MSSQL, and others) run as plugins. The first time you pick one, TablePro asks to download the driver before opening the form.
</Note>

## Step 3: Fill In, Test, and Save

The form pre-fills the host (`localhost`) and the default port. The username is optional; leave it empty and the database uses its own default, the same way `psql` and `mysql` do. Typical values:

* **MySQL**: port `3306`
* **PostgreSQL**: port `5432`
* **MongoDB**: port `27017`
* **SQLite**: browse to a `.sqlite` or `.db` file, no auth needed

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

  <img className="hidden dark:block" src="https://mintcdn.com/ngquct-feat-ai-sql-walkthroughs/REI9tfF_TGivM099/images/connection-form-general-dark.png?fit=max&auto=format&n=REI9tfF_TGivM099&q=85&s=506368ad10fa6e09b02f39917b21e079" 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>

Click **Test Connection** in the **Status** row at the bottom of the General pane. When 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-feat-ai-sql-walkthroughs/REI9tfF_TGivM099/images/connection-test.png?fit=max&auto=format&n=REI9tfF_TGivM099&q=85&s=7713ddea80d9bed5bdf2ea1260fed6b5" alt="Connection test success" width="1440" height="1224" data-path="images/connection-test.png" />

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

## Step 4: Run Your First Query

The main window has three panels: the sidebar (databases and tables), the SQL editor, and the data grid for results.

<Frame caption="TablePro main interface">
  <img className="block dark:hidden" src="https://mintcdn.com/ngquct-feat-ai-sql-walkthroughs/REI9tfF_TGivM099/images/app.png?fit=max&auto=format&n=REI9tfF_TGivM099&q=85&s=8731160dc7681378f4b2baa3ae0bdd1d" alt="Main interface" width="3024" height="1722" data-path="images/app.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/ngquct-feat-ai-sql-walkthroughs/REI9tfF_TGivM099/images/app-dark.png?fit=max&auto=format&n=REI9tfF_TGivM099&q=85&s=15c5003baaa6253c821cac9b4ab618a6" alt="Main interface" width="3024" height="1722" data-path="images/app-dark.png" />
</Frame>

Click a table in the sidebar to browse it, or type a query in the editor and press `Cmd+Enter`:

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

## 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? [Open an issue](https://github.com/TableProApp/TablePro/issues) on GitHub.