Getting Started


The GeekLoad can be installed in your environment as a set of Docker containers or used from one of the integration plugins.


InfoTo use the GeekLoad or his agent, you can use any computer with at least 2 cores and 4 gigabytes of RAM.
Also you must have Docker-compose installed.

To install it just download the archive from our downloads page with the configuration files and run the 'install' batch file from the downloaded archive.
The necessary docker containers will be downloaded and launched. Then try running the example:


The archive also contains a Samples directory with projects that demonstrate different features.


How do i create project?

To try out an example project, copy its script to a new file with the extension.gl-js and save it in the project directory.
Then run with this command line or WebUI:

InfoEach project must contain the main() function without parameters.
This function will be launched when the project is launched.

Hello world

A minimal project script that simply adds messages to the log:


To simply check the availability of any endpoint, use this script:


Request parameterization

Separate specification of request parameters:

InfodemoServer is a built-in variable containing the address of the demo server as part of GeekLoad

Using an object with a set of fields:

InfoHeaders, cookies, query, and body, can be set in two ways - as separate params and object with a set of fields.

A chain of requests

If it is necessary to make several consecutive requests within the same connection, these requests can be combined into a chain of calls:


Request postprocessing

InfoThe then method is designed to perform various checks and/or save data after the successful execution of the request.

Checking the values in the response:


Saving the value from the response to a special storage Session and its usage:



Simplest case

InfoThe group describes a dynamic distributed group of virtual users running a common scenario.

Executing 10 virtual users with a simple scenario within 5 seconds:


Groups with complex profile

InfoShape describes the curve of change in the number of virtual users over time.InfoThe profile describes the duration of the group and the number of virtual users at each time of group duration.

This project smoothly increases the load from 0 to 100 virtual users then holds 100 vu for 10 seconds and then gradually reduces to 0:


Complex project

InfoA project can contain any number of stages performed sequentially.
Each stage can contain one or more groups executed in parallel.
A Group launched outside the stage is completely equivalent to a stage with this group.

A test plan of 3 stages can be implemented in the form of a similar project below.
Real tests sometimes find errors. This project will find them too. We promise.


Distribution load

InfoCloud is a source of agents in a given location, managed by a given provider (Private, Amazon, etc.)InfoDistribution describes the distribution of virtual users of each group by locations.

Real distributed tests require some preliminary preparation and resources.
Therefore, the project this project shows only the concept of clouds and distributions:


What else?

The examples above describe only a small part of the functionality of the GeekLoad.
Do not stop on this journey through the possibilities of GeekLoad!
It will be interesting!


FeatureSee the examples from the delivery setFeatureStudy the other sections of this documentationFeatureVisit our public collection of examples on GitHubFeatureWrite to us if something seems wrong or insufficient!FeatureAnd read more about Performance Testing, because no tool will replace your deep understanding of the testing process.
Help banner

© House of Geeks 2024