Command-line options

To run a test, use the molotov runner and point it to the scenario module or path:

Load test.

usage: molotov [-h] [-s SINGLE_MODE] [--config CONFIG] [--version] [--debug]
               [-v] [-w WORKERS] [-p PROCESSES] [-d DURATION] [-r MAX_RUNS]
               [-q] [-x] [-c] [--statsd] [--statsd-server STATSD_SERVER]
               [--statsd-port STATSD_PORT]

Positional Arguments


path or module name that contains scenarii

Default: “”

Named Arguments

-s, –single-mode
 Name of a single scenario to run once.
–config Point to a JSON config file.

Displays version and exits.

Default: False


Run the event loop in debug mode.

Default: False

-v, –verbose

Verbosity level. -v will display tracebacks. -vv requests and responses.

Default: 0

-w, –workers

Number of workers

Default: 1

-p, –processes

Number of processes

Default: 1

-d, –duration

Duration in seconds

Default: 86400

-r, –max-runs Maximum runs per worker
-q, –quiet


Default: False

-x, –exception

Stop on first failure.

Default: False

-c, –console

Use simple console for feedback

Default: False


Activates statsd

Default: False


Statsd Server

Default: “”


Statsd Port

Default: 8125