# Install and configure.

The prerequisites, the package, and the two environment variables every integration needs.

:::info[Prerequisites]
Node.js 20 or later, an active Helix Space ID, a shared secret from the Helix admin panel, and an HTTPS-served
callback endpoint in production. Test credentials are listed under [Testing & credentials](https://docs.helix.id/testing.md).
:::

## 1. Install the package

Install via npm — or your package manager of choice\:

:::code-group
```bash [npm]
npm install @helix-id/node
```

```bash [pnpm]
pnpm add @helix-id/node
```

```bash [yarn]
yarn add @helix-id/node
```

```bash [bun]
bun add @helix-id/node
```
:::

## 2. Configure environment variables

Add your Space ID and shared secret to your environment. Never commit either to source control.

```bash
# .env
HELIX_SPACE_ID=a1b2c3d4-e5f6-7890-abcd-ef1234567890
HELIX_SECRET=tk_live_hx_…
```

:::info[Note]
The default portal URL is `https://capsule.helix.id`. You only need to override it if your contract specifies a
regional or self-hosted portal — see `baseUrl` in the [API reference](https://docs.helix.id/api.md).
:::

## 3. Confirm the integration

With credentials in place, follow the [Quickstart](https://docs.helix.id/quickstart.md) to wire the redirect and callback. Local development can use the [test credentials](https://docs.helix.id/testing.md) in lieu of a real Space.