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

# Using the Dashboard

> Sign in, create a workspace and project, provision a database, and test the connection

<div className="flex flex-wrap gap-2"><Badge color="green" size="sm">Tutorial</Badge></div>

> For the complete documentation index optimized for AI agents, see [llms.txt](/llms.txt).

Use the Helix Cloud dashboard to organize databases into workspaces and projects,
choose a managed plan, and create API keys.

<Steps>
  <Step title="Sign in">
    Open the [Helix Cloud dashboard](https://helix-db.com/login) and select
    **GitHub Login**. When prompted, enter the one-time verification code from
    the email sent by WorkOS.

    <Frame>
      <img src="https://mintcdn.com/helix/phWxBn15vXE1Dg2t/images/helix-cloud/dashboard/01-login.png?fit=max&auto=format&n=phWxBn15vXE1Dg2t&q=85&s=c1530c4aa774532e7b420c225a649a8a" alt="Helix Cloud login page with the GitHub Login button" width="4874" height="2612" data-path="images/helix-cloud/dashboard/01-login.png" />
    </Frame>
  </Step>

  <Step title="Create a workspace">
    Enter a workspace name, select the region for future dedicated clusters,
    and select **Create Workspace**.

    <Note>
      New workspaces currently support only the `us-east-1` region.
    </Note>

    <Frame>
      <img src="https://mintcdn.com/helix/phWxBn15vXE1Dg2t/images/helix-cloud/dashboard/02-create-workspace.png?fit=max&auto=format&n=phWxBn15vXE1Dg2t&q=85&s=c4b5ff7f0a8a381dbd757cc324809e17" alt="Create a Workspace form with workspace name and region fields" width="3460" height="2132" data-path="images/helix-cloud/dashboard/02-create-workspace.png" />
    </Frame>
  </Step>

  <Step title="Create a project">
    Select **Create Project**, then give the project a name. Projects group the
    databases and dedicated clusters for an application or environment.

    <Frame>
      <img src="https://mintcdn.com/helix/phWxBn15vXE1Dg2t/images/helix-cloud/dashboard/03-create-project.png?fit=max&auto=format&n=phWxBn15vXE1Dg2t&q=85&s=3abad1b8bc6f61d1417444f965a8fcf1" alt="Helix Cloud project list with the Create Project action" width="3706" height="2216" data-path="images/helix-cloud/dashboard/03-create-project.png" />
    </Frame>
  </Step>

  <Step title="Start creating a database">
    Open the project and select **Create Database**.

    <Frame>
      <img src="https://mintcdn.com/helix/phWxBn15vXE1Dg2t/images/helix-cloud/dashboard/04-project-databases.png?fit=max&auto=format&n=phWxBn15vXE1Dg2t&q=85&s=0c13d75dce9149602e6770798c6f59b0" alt="Empty project with options to create a database or deploy a dedicated cluster" width="3994" height="2354" data-path="images/helix-cloud/dashboard/04-project-databases.png" />
    </Frame>
  </Step>

  <Step title="Choose a name and plan">
    Keep **Database** selected, enter a database name, choose a monthly plan,
    and select **Create Database**. The plan determines the included read and
    write query allowance.

    <Frame>
      <img src="https://mintcdn.com/helix/phWxBn15vXE1Dg2t/images/helix-cloud/dashboard/05-create-database.png?fit=max&auto=format&n=phWxBn15vXE1Dg2t&q=85&s=685791840e6fede4855ecd8eda3dea29" alt="Create Database form with database name and monthly plan options" width="3656" height="2344" data-path="images/helix-cloud/dashboard/05-create-database.png" />
    </Frame>
  </Step>

  <Step title="Copy the connection details">
    Wait for the database status to become **Active**, then open it. In
    **Connect**, copy the endpoint and database ID. In **API Keys**, create a key
    or use an existing one and copy its value when it is shown.

    <Frame>
      <img src="https://mintcdn.com/helix/phWxBn15vXE1Dg2t/images/helix-cloud/dashboard/06-database-details.png?fit=max&auto=format&n=phWxBn15vXE1Dg2t&q=85&s=d9c9e89ce4b35adeff643274987ac468" alt="Active database details page with endpoint, database ID, API keys, and query insights" width="5974" height="3466" data-path="images/helix-cloud/dashboard/06-database-details.png" />
    </Frame>
  </Step>
</Steps>

## Test the connection

Set the three values copied from the database page, then send this read-only
query. It counts `User` nodes, so it also succeeds on a new database with a count
of `0`.

```bash theme={"languages":{"custom":["languages/helixql.json"]}}
export HELIX_ENDPOINT="https://<cluster>.cluster.helix-db.com"
export HELIX_DATABASE_ID="<database-id>"
export HELIX_API_KEY="<api-key>"

curl --fail-with-body --silent --show-error \
  "$HELIX_ENDPOINT/v2/query" \
  --header "Authorization: Bearer $HELIX_API_KEY" \
  --header "x-helix-tenant-id: $HELIX_DATABASE_ID" \
  --header "Content-Type: application/json" \
  --data-binary @- <<'JSON'
{
  "request_type": "read",
  "query_name": "connection_test",
  "query": {
    "read": {
      "entries": [
        {
          "query": {
            "name": "user_count",
            "root": {
              "count": {
                "input": {
                  "nodes_where": {
                    "predicate": {
                      "eq": {
                        "left": { "property": "$label" },
                        "right": { "constant": { "string": "User" } }
                      }
                    }
                  }
                }
              }
            }
          }
        }
      ],
      "returns": ["user_count"]
    }
  }
}
JSON
```

Keep API keys in a secrets manager or environment variable. Do not commit them
to source control.

## Next steps

<CardGroup cols={2}>
  <Card title="Helix Cloud overview" icon="cloud" href="/database/helix-cloud/start-here/working-with-enterprise">
    Connect from an SDK and understand Cloud request routing.
  </Card>

  <Card title="Security" icon="lock" href="/database/helix-cloud/operate/security">
    Review authentication, encryption, and API key handling.
  </Card>

  <Card title="TypeScript SDK setup" icon="code" href="/database/helix-db/start-here/sdk-setup/typescript-project-setup">
    Install the SDK and connect a Node.js application.
  </Card>

  <Card title="Query walkthrough" icon="rocket" href="/database/helix-db/core-concepts/overview">
    Build and run a query step by step.
  </Card>
</CardGroup>
