> ## 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 Cloud

> Sign in, create a workspace and choose its plan, 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 Helix Cloud to create a workspace, choose a monthly plan shared by its
databases, provision a database, 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/r0Fr45pwv5sNp5j6/images/helix-cloud/dashboard/01-login.png?fit=max&auto=format&n=r0Fr45pwv5sNp5j6&q=85&s=0a6e2d7bffa3689016165aeeb664e016" alt="Helix Cloud login page with the GitHub Login button" width="4752" height="3400" data-path="images/helix-cloud/dashboard/01-login.png" />
    </Frame>
  </Step>

  <Step title="Create a workspace and choose a plan">
    Enter a workspace name, choose a monthly plan, and select **Create
    workspace**. The plan's read and write allowances are shared by every
    database in the workspace. You can change the plan later from **Billing**.

    <Frame>
      <img src="https://mintcdn.com/helix/r0Fr45pwv5sNp5j6/images/helix-cloud/dashboard/02-create-workspace.png?fit=max&auto=format&n=r0Fr45pwv5sNp5j6&q=85&s=d789e8be2e14ab46780e393a700186bd" alt="Create a workspace form with workspace name and monthly plan options" width="4600" height="3260" data-path="images/helix-cloud/dashboard/02-create-workspace.png" />
    </Frame>
  </Step>

  <Step title="Create a database">
    Enter a database name and select **Create Database**. Helix Cloud generates
    its URL slug. The database has isolated data and uses the workspace's shared
    monthly allowance.

    <Frame>
      <img src="https://mintcdn.com/helix/r0Fr45pwv5sNp5j6/images/helix-cloud/dashboard/03-create-database.png?fit=max&auto=format&n=r0Fr45pwv5sNp5j6&q=85&s=080f4c7306e100dd1ba4d204b17b458c" alt="Create a Database form with a database name field" width="3888" height="2284" data-path="images/helix-cloud/dashboard/03-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/r0Fr45pwv5sNp5j6/images/helix-cloud/dashboard/04-database-details.png?fit=max&auto=format&n=r0Fr45pwv5sNp5j6&q=85&s=dfca057010991a04803fcc0bf8853ae0" alt="Active database details page with connection details, workspace plan, API keys, and query insights" width="1920" height="1240" data-path="images/helix-cloud/dashboard/04-database-details.png" />
    </Frame>
  </Step>
</Steps>

## Test the connection

Set the three values copied from the database page, then count the database's
nodes. A successful response, such as `{"node_count":0}`, confirms the connection.

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

curl --fail-with-body \
  "$HELIX_ENDPOINT/v2/query" \
  --header "Authorization: Bearer $HELIX_API_KEY" \
  --header "x-helix-tenant-id: $HELIX_DATABASE_ID" \
  --header "Content-Type: application/json" \
  --data '{
    "request_type": "read",
    "query": {
      "read": {
        "entries": [
          {
            "query": {
              "name": "node_count",
              "root": {
                "count": {
                  "input": {
                    "nodes": { "reference": "all" }
                  }
                }
              }
            }
          }
        ],
        "returns": ["node_count"]
      }
    }
  }'
```

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>
