# Installation

## System Requirements

| Requirement      | Details                                        |
| ---------------- | ---------------------------------------------- |
| Node.js          | v18 or later ([Download](https://nodejs.org/)) |
| npm              | Included with Node.js                          |
| Operating System | Linux, macOS, Windows                          |

## Prerequisites

Before installing, gather the following:

| Item                     | Where to Find                                                                                                                                                                     |
| ------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| qTest instance URL       | Your qTest instance URL, e.g. `https://company.qtestnet.com`                                                                                                                      |
| qTest username           | Your qTest login email                                                                                                                                                            |
| qTest password           | Your qTest login password                                                                                                                                                         |
| qTest client credentials | Usually `bGluaC1sb2dpbjo=` — contact your qTest administrator if different                                                                                                        |
| SeaLights agent token    | Generate one from your SeaLights account — see [Generating a Token](https://docs.sealights.io/knowledgebase/settings/token-access-and-management#token-list-and-token-creation-2) |

{% hint style="info" %}
If your organization uses a corporate proxy, see [Proxy Configuration](https://docs.sealights.io/knowledgebase/setup-and-configuration/integrations/configuration#proxy-configuration) before proceeding.
{% endhint %}

## Install

{% hint style="info" %}
The SeaLights qTest Integration Tool is distributed as a controlled package. Contact your SeaLights Customer Success representative to receive the installation package and version appropriate for your environment.
{% endhint %}

Once you have received the package, extract it and install its dependencies:

```bash
cd sl-qtest-integration-tool
npm install
```

## Verify the Installation

Compile the TypeScript source to confirm everything installed correctly:

```bash
npm run build
```

You should see no errors. If you see TypeScript compilation errors, verify your Node.js version with `node --version`.

## Secure Your Configuration File

The tool stores your credentials (qTest password, tokens) in `config.json`. You must set restrictive file permissions to prevent other users on the machine from reading it.

{% tabs %}
{% tab title="Linux / macOS" %}

```bash
chmod 600 config.json
```

{% endtab %}

{% tab title="Windows (PowerShell)" %}

```powershell
icacls config.json /inheritance:r /grant:r "$($env:USERNAME):F"
```

{% endtab %}
{% endtabs %}

{% hint style="warning" %}
`config.json` is already in `.gitignore` to prevent accidental commits. Never store this file in a shared or public directory, and never commit it to version control.
{% endhint %}

See [Configuration — Security](https://docs.sealights.io/knowledgebase/setup-and-configuration/integrations/configuration#security) for the full list of security best practices.

## What's Stored in config.json

The following sensitive values are written to `config.json` during setup:

* qTest username and password (OAuth)
* qTest bearer token
* qTest client credentials
* SeaLights agent token

## Next Steps

Once installed, run the setup wizard to configure your connections:

```bash
npm run setup
```

See [Quick Start](https://docs.sealights.io/knowledgebase/setup-and-configuration/integrations/qtest-integration/quick-start) for the full first-run walkthrough, or [Setup Wizard](https://docs.sealights.io/knowledgebase/setup-and-configuration/integrations/qtest-integration/commands/setup) for detailed wizard documentation.