> For the complete documentation index, see [llms.txt](https://docs.sealights.io/knowledgebase/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sealights.io/knowledgebase/setup-and-configuration/integrations/qtest-integration/installation.md).

# 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](/knowledgebase/setup-and-configuration/integrations/qtest-integration/configuration.md#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](/knowledgebase/setup-and-configuration/integrations/qtest-integration/configuration.md#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](/knowledgebase/setup-and-configuration/integrations/qtest-integration/quick-start.md) for the full first-run walkthrough, or [Setup Wizard](/knowledgebase/setup-and-configuration/integrations/qtest-integration/commands/setup.md) for detailed wizard documentation.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.sealights.io/knowledgebase/setup-and-configuration/integrations/qtest-integration/installation.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.