> ## Documentation Index
> Fetch the complete documentation index at: https://docs.synehq.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Set up your first connection and get insights in minutes

<Frame>
  <img src="https://synehq.gitbook.io/synehq/~gitbook/image?url=https%3A%2F%2F2839184068-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fh3pxl4sSLyris6mbVyHW%252Fuploads%252FZHnIPbVpUXc3ZqMR8BMi%252Fimage.png%3Falt%3Dmedia%26token%3D041db3fd-7145-4ae9-abe4-fcd72686e37f&width=768&dpr=2&quality=100&sign=1b479b3a&sv=2" />
</Frame>

## Who this is for

* **New users** who want to see value in minutes
* **Teams evaluating SyneHQ** for SaaS or enterprise self-hosting
* **Stakeholders** who want a fast, realistic demo path

<Info>
  You can use SyneHQ as a managed SaaS or deploy it in your own environment (enterprise). This quick start focuses on the fastest SaaS path, with notes for self-hosted where relevant.
</Info>

## Step 1 — Sign in

1. Go to `https://data.synehq.com`
2. Create an account or sign in
3. Complete the onboarding tour (optional)

<CardGroup cols={2}>
  <Card title="Sign Up" icon="user-plus" href="https://data.synehq.com">
    Create your SyneHQ account
  </Card>

  <Card title="Overview" icon="house" href="/get-started/overview">
    Learn what SyneHQ can do
  </Card>
</CardGroup>

## Step 2 — Connect a data source (2 minutes)

1. Go to `Home → Connections`
2. Click `Add connection`
3. Choose your database (e.g., PostgreSQL, MySQL, MongoDB)
4. Enter host, database, user, and password
5. Click `Test` then `Save`

![](https://synehq.gitbook.io/synehq/~gitbook/image?url=https%3A%2F%2F2839184068-files.gitbook.io%2F%7E%2Ffiles%2Fv0%2Fb%2Fgitbook-x-prod.appspot.com%2Fo%2Fspaces%252Fh3pxl4sSLyris6mbVyHW%252Fuploads%252Fda8enFKsBhV2JPxMNM5e%252Fimage.png%3Falt%3Dmedia%26token%3D3c373c19-0c38-4100-9866-fb69e61718f1\&width=768\&dpr=2\&quality=100\&sign=1fda0473\&sv=2)

<Note>
  Prefer a guided setup? Use the help in `Home → Connections` for a step‑by‑step tour.
</Note>

<Card title="See supported data sources" icon="database" href="/get-started/data-sources">
  Full list of SQL, NoSQL, and analytics sources
</Card>

## Setp 3 - Ask your first question

1. Go to `Chat → Chat Input`
2. Select your connection of choice
3. In the ask box, type: "Show me a heatmap of trip density by neighbourhood"

![KBmxf7p.md.png](https://iili.io/KBmxf7p.png)

## Step 4 — Ask your first database query

1. Go to `Console → Queries`
2. In the ask box, type: "Show me total revenue by month"
3. Select your connection, then run
4. Review the generated SQL and results

```sql theme={"system"}
-- Example SQL the AI may generate
SELECT DATE_TRUNC('month', order_date) AS month,
       SUM(amount) AS total_revenue
FROM orders
GROUP BY month
ORDER BY month;
```

<Card title="AI features" icon="brain" href="/get-started/ai-features">
  Tips for better natural language questions
</Card>

## Step 4 — Visualize and share

1. Click `Visualize` and choose a chart type
2. Save as a `Dashboard` (name it "Revenue Overview")
3. Share with your team using access controls

<CardGroup cols={2}>
  <Card title="Create dashboards" icon="chart-line" href="/get-started/overview#core-capabilities">
    From query to chart in one click
  </Card>

  <Card title="Deployment options" icon="cloud" href="/get-started/deployment">
    SaaS, self‑hosted (enterprise), or hybrid
  </Card>
</CardGroup>

## Optional — Self-hosted quick path (enterprise)

* Deploy the app, then repeat Steps 2–4 inside your environment
* Use secure tunneling for local/private databases
* Integrate SSO and enterprise RBAC

<Card title="Enterprise deployment" icon="server" href="/get-started/deployment#self-hosted-enterprise">
  Install with Docker, Compose, or Kubernetes
</Card>

## Troubleshooting

* **Connection failed**: Verify host/port, network/firewall, and credentials
* **SSL errors**: Ensure correct certificates or disable verify in dev
* **No tables found**: Check DB permissions for the SyneHQ user
* **Slow queries**: Start with smaller tables; see performance tips

<CardGroup cols={2}>
  <Card title="Connection guide" icon="plug" href="/get-started/data-sources#connection-methods">
    Connection strings, security, and tuning
  </Card>

  <Card title="Performance tips" icon="speed" href="/get-started/architecture#scalability-features">
    Caching, indexing, and scaling options
  </Card>
</CardGroup>

## Next steps

* Connect more sources (PostgreSQL + MongoDB + ClickHouse)
* Try cross‑database joins ("Compare web and app users")
* Build a team dashboard and schedule reviews
* Set up SSO and roles for your organization

<CardGroup cols={3}>
  <Card title="Data Sources" icon="database" href="/get-started/data-sources">
    Add more connections
  </Card>

  <Card title="AI Features" icon="brain" href="/get-started/ai-features">
    Query smarter with natural language
  </Card>

  <Card title="Deployment" icon="cloud" href="/get-started/deployment">
    Choose SaaS or enterprise self-hosted
  </Card>
</CardGroup>