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

# helix add

> Add a local instance or a Cloud database link

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

```bash theme={"languages":{"custom":["languages/helixql.json"]}}
helix add local --name dev [--port 6969] [--disk | --storage-uri s3://bucket/prefix]
helix add cloud --name production [--database tenant:<id>|cluster:<id>] \
  [--project <id>] [--workspace <id>]
```

Cloud add uses the WorkOS session, verifies the selected database, and writes only stable IDs to
`helix.toml`. If a project has multiple eligible databases, pass `--database` explicitly.