---
title: "Installation"
description: "The prerequisites, the package, and the two environment variables every integration needs."
source: "/docs/installation"
updated: "2026-09-24"
---

# 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](/docs/testing.md).

## 1. Install the package

Install via npm - or your package manager of choice:

*npm*

```bash
npm install @helix-id/node
```

*pnpm*

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

*yarn*

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

*bun*

```bash
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](/docs/api.md).

## 3. Confirm the integration

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


## Sitemap

See the full [sitemap](https://helix.id/sitemap.md) for all pages.