Installation
System Requirements
Prerequisites
Before installing, gather the following:
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
If your organization uses a corporate proxy, see Proxy Configuration before proceeding.
Install
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.
Once you have received the package, extract it and install its dependencies:
cd sl-qtest-integration-tool
npm installVerify the Installation
Compile the TypeScript source to confirm everything installed correctly:
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.
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.
See 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:
See Quick Start for the full first-run walkthrough, or Setup Wizard for detailed wizard documentation.
Last updated
Was this helpful?