SmartestQADocs
AGENT POOL

Agent Pool

Manage test execution hosts and agents. Run your tests on Localhost, Virtual Machines, or your own infrastructure using the SmartestQA agent.

Overview

The Agent Pool allows you to connect external machines to SmartestQA and execute test cases on those hosts. Each host runs a lightweight agent that communicates with the SmartestQA platform.

Localhost

Run tests on your own machine

Virtual Machines

Connect VMs to the agent pool

The agent runs as a background service on the host machine and receives test execution commands from the SmartestQA platform using your API Key.

Hosts List

The Hosts List panel on the left side of the Agent Pool page shows all registered hosts in two categories: Localhost and Virtual Machine List.

Localhost

Your primary local machine. This host is automatically registered when you download and run the agent for the first time.

user@example.com

offline

Virtual Machine List

Additional hosts you've added — including virtual machines or other remote machines.

example

offline

ahmetagent

offline

Host Status Indicators

Online — Agent is running and ready
Offline — Agent is not running

Adding a New Host

Click the + New Host button at the top of the Hosts List to register a new machine.

Steps

  1. 1 Click + New Host in the Hosts List panel
  2. 2 Enter a name for the host in the Host Name field
  3. 3 Click Create to register the new host
  4. 4 Download and run the agent on the target machine using the generated API Key

New Host Dialog

New Host

Host Details

Clicking on a host in the list displays its details in the center panel. This panel contains all the information you need to connect the agent to the platform.

Host Name

The unique identifier for this host. Displayed in the Hosts List and used when assigning test executions.

user@example.com

API Key

The unique API Key for this host. When the agent starts, it will prompt you to enter this key. Copy it using the copy button on the right.

a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4

Agent Version

Shows the version of the agent currently running on this host. Populated automatically once the agent connects successfully.

Populated when the agent connects

To use the agent you created, please download it from the link on the right and run it. Once the agent starts, it will ask for your API Key. You can enter the API Key provided in the form above. When the setup is successful, the agent icon will turn green. At this point, you are ready to start using the agent.

Download Client

The Download Client tab on the right panel lets you download the SmartestQA agent installer for your platform.

Download Client Install Via CLI

Select your platform to download the agent:

Agent Version

Windows

Downloads a .exe installer. Run it to install the SmartestQA agent as a Windows service.

  1. 1. Click Windows to download the installer
  2. 2. Run the .exe file
  3. 3. Enter your API Key when prompted
  4. 4. The agent icon turns green when ready

Mac

Downloads a .dmg installer. Mount and install to run the agent on macOS.

  1. 1. Click Mac to download the installer
  2. 2. Open the .dmg and drag to Applications
  3. 3. Launch the app and enter your API Key
  4. 4. The agent icon turns green when ready

Install Via CLI

Install and run the SmartestQA agent directly from the command line using a single command. Replace YOUR_API_KEY with the API Key shown in your host's detail panel.

Windows (PowerShell / Command Prompt)

Caution: This command must be run from PowerShell or Command Prompt on Windows and requires curl.exe and 7-Zip to be installed on the system.

curl.exe -L -o app.rar "http://cdn.smartestqa.ai/cdn/file/1/3/SmartTest-Desktop-v1.0.0-Package.rar";`
& "$env:ProgramFiles\7-Zip\7z.exe" x -y app.rar -oapp;`
& ".\app\SmartTest-Desktop-v1.0.0-Package\SmartTest-Desktop.exe" --apikey=YOUR_API_KEY
What this command does
  1. 1 Downloads the SmartTest Desktop package (app.rar) from the CDN using curl.exe
  2. 2 Extracts the archive to the app folder using 7-Zip
  3. 3 Launches SmartTest-Desktop.exe with your --apikey to connect the agent to the platform

Prerequisites: Make sure curl.exe (available by default on Windows 10/11) and 7-Zip are installed before running this command.

API Request Tasks