Dockload

A load testing tool that can spin up Docker containers as targets and hammer them with concurrent requests. Built for quick local performance checks without setting up a full test environment.

What it does

• Run HTTP load tests against any URL
• Optionally launch an nginx container as a test target via Docker SDK
• Track requests per second, error rate, and latency percentiles
• Export results as JSON or print a summary table

Requirements

• Python 3.10+
• Docker installed and running (only needed for --docker mode)

Setup

python -m venv venv
source venv/bin/activate
pip install -r requirements.txt

Usage

Test an existing URL:

python -m src.cli --url http://localhost:8080 --requests 500 --concurrency 20

Spin up a Docker container and test it:

python -m src.cli --docker --requests 1000 --concurrency 50

Save results to a file:

python -m src.cli --url http://myapp.local/api --requests 200 --output results.json

Options

Flag	Default	Description
--url	-	Target URL to test
--docker	off	Start nginx container as target
--requests	100	Total number of requests
--concurrency	10	Parallel workers
--timeout	10	Request timeout in seconds
--output	-	Save JSON report to file

Stack

Python, asyncio, aiohttp, Docker SDK