> ## Documentation Index
> Fetch the complete documentation index at: https://ngquct-feat-721-compare-sync.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

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 with **Create Connection...** and an **Add from Existing** menu. Your saved connections are on the right. The `+` button, the group button, and the search field sit at the top of the connections panel. Press `Cmd+F` to focus search. Each connection shows its tags and group.

* **Add from Existing** holds **Import from URL...**, **Import from Other App...** (TablePlus, DataGrip, DBeaver, Beekeeper Studio, Sequel Ace, and others), **Open Project Folder...**, and **Import Connections...**.
* With no connections saved yet, the right panel offers **Try Sample Database**. It opens the bundled Chinook SQLite database, no server needed. Reset it any time from **File > Reset Sample Database...**.

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-721-compare-sync/TlGri84ui62H4Saf/images/database-type-chooser.png?fit=max&auto=format&n=TlGri84ui62H4Saf&q=85&s=557cc60f9ec6eec39fea2fcd9ec19208" 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-721-compare-sync/TlGri84ui62H4Saf/images/database-type-chooser-dark.png?fit=max&auto=format&n=TlGri84ui62H4Saf&q=85&s=09b03f3c66d8e39ada3a008fc16976ad" 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-721-compare-sync/TlGri84ui62H4Saf/images/connection-form-general.png?fit=max&auto=format&n=TlGri84ui62H4Saf&q=85&s=d65612e981c8abc341c0cac7d8e41f3d" 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-721-compare-sync/TlGri84ui62H4Saf/images/connection-form-general-dark.png?fit=max&auto=format&n=TlGri84ui62H4Saf&q=85&s=8e1614a0fa17f5658059a3ffce04a4a3" 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-721-compare-sync/TlGri84ui62H4Saf/images/connection-test.png?fit=max&auto=format&n=TlGri84ui62H4Saf&q=85&s=0544b605e1325b4d24bc497607e62149" 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-721-compare-sync/TlGri84ui62H4Saf/images/connection-test-dark.png?fit=max&auto=format&n=TlGri84ui62H4Saf&q=85&s=53cde116c1dacc34fea0f8d4e46164b4" 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 a sidebar on the left (databases and tables), the open tab in the middle, and an inspector on the right. A table tab shows the data grid. A query tab puts the SQL editor above the result grid.

<Frame caption="A table tab showing the data grid">
  <img className="block dark:hidden" src="https://mintcdn.com/ngquct-feat-721-compare-sync/TlGri84ui62H4Saf/images/app.png?fit=max&auto=format&n=TlGri84ui62H4Saf&q=85&s=b88a64c240fc5bbb957223b1e874d120" alt="Main interface" width="3024" height="1722" data-path="images/app.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/ngquct-feat-721-compare-sync/TlGri84ui62H4Saf/images/app-dark.png?fit=max&auto=format&n=TlGri84ui62H4Saf&q=85&s=5c4daea004632b8267082756f377700d" alt="Main interface" width="3024" height="1722" data-path="images/app-dark.png" />
</Frame>

Click a table in the sidebar to browse it. For SQL, press `Cmd+T` to open a query tab, type a query, 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.