> ## Documentation Index
> Fetch the complete documentation index at: https://ngquct-refactor-theme-settings-panes.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

With no connections saved, the welcome window offers **Open Sample Database**, a bundled Chinook SQLite file that needs no server and drops you at step 4. Reset it any time from **Help > Reset Sample Database…**.

<Steps>
  <Step title="Install TablePro">
    `brew install --cask tablepro`, or the DMG from GitHub Releases. See [Installation](/installation). The first launch shows a welcome sheet; click **Continue** to reach the welcome window, and choose **Help > Getting Started** to see it again.
  </Step>

  <Step title="Create a connection">
    Click **New Connection…** in the welcome window, pick a type in the **Choose a Database** sheet, then click **Continue**. A type badged **Not Installed** downloads its driver before the form opens, with no restart.

    <Frame caption="Pick a database type">
      <img className="block dark:hidden" src="https://mintcdn.com/ngquct-refactor-theme-settings-panes/Xj_nEQbOOt5Zpisq/images/database-type-chooser.png?fit=max&auto=format&n=Xj_nEQbOOt5Zpisq&q=85&s=cd50fe3ebeaabf2682450da7fe059b85" 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-refactor-theme-settings-panes/Xj_nEQbOOt5Zpisq/images/database-type-chooser-dark.png?fit=max&auto=format&n=Xj_nEQbOOt5Zpisq&q=85&s=94232b5142ebc85a71ae0e07095ef351" alt="Database type chooser" width="1400" height="964" data-path="images/database-type-chooser-dark.png" />
    </Frame>

    <Tip>
      Already have a connection URL, another client's connections, or a repository with a `.env`? The **Import** menu under **New Connection…** takes all three. See [Switching to TablePro](/switching).
    </Tip>
  </Step>

  <Step title="Fill in the form, test it, save it">
    The host pre-fills to `localhost` and the port to the engine's default. Username is optional: leave it empty and the database applies its own default. SQLite asks for a `.sqlite` or `.db` file instead of a host, with no credentials.

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

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

    Click **Test Connection** on the bar along the bottom. It turns into **Connected** with a green checkmark. Now click **Save & Connect** beside it.

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

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

    <Check>
      The window switches to the main layout: databases and tables in the sidebar, the open tab in the middle, the inspector on the right.
    </Check>

    A failed attempt paints the window with the driver's own message and a **Try Again** button instead. [Troubleshooting](/troubleshooting) sorts refused from timed out.
  </Step>

  <Step title="Run a query">
    Click a table in the sidebar to browse it. For SQL, press `Cmd+T` for a query tab, type, and press `Cmd+Enter` to run the statement under the cursor.

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

      <img className="hidden dark:block" src="https://mintcdn.com/ngquct-refactor-theme-settings-panes/Xj_nEQbOOt5Zpisq/images/app-dark.png?fit=max&auto=format&n=Xj_nEQbOOt5Zpisq&q=85&s=b14e229d8654f30ab6e6e1323a70ec54" alt="Main interface" width="3024" height="1722" data-path="images/app-dark.png" />
    </Frame>

    ```sql theme={null}
    SELECT * FROM users LIMIT 10;
    ```
  </Step>
</Steps>

## What's next

[Managing connections](/connections), [SSH tunneling](/connections/ssh-tunneling), [keyboard shortcuts](/features/keyboard-shortcuts), and [AI features](/features/ai-assistant). Anything that goes wrong is worth an [issue](https://github.com/TableProApp/TablePro/issues).