Chart version: 0.2.0
Api version: v1
App version: 0.7.5
A modern load testing framework
Chart Type
Set me up:
helm repo add center
Install Chart:
helm install locust center/fasterbytes/locust
Versions (0)

Locust Helm Chart

This is a templated deployment of Locust for Distributed Load testing using Kubernetes.

Pre Requisites:

  • Requires (and tested with) helm v2.1.2 or above.

Chart details

This chart will do the following:

  • Convert all files in tasks/ folder into a configmap
  • Create a Locust master and Locust worker deployment with the Target host and Tasks file specified.

Installing the chart

To install the chart with the release name locust-nymph in the default namespace:

helm install -n locust-nymph --set stable/locust
Parameter Description Default
Name Locust master name locust
image.repository Locust container image name
image.tag Locust Container image tag 0.7.5
service.type k8s service type exposing master NodePort
service.nodePort Port on cluster to expose master 0
service.annotations KV containing custom annotations {}
service.extraLabels KV containing extra labels {} locust target host
worker.config.locust-script locust script to run /locust-tasks/
worker.replicaCount Number of workers to run 2

Specify parameters using --set key=value[,key=value] argument to helm install

Alternatively a YAML file that specifies the values for the parameters can be provided like this:

$ helm install --name my-release -f values.yaml stable/locust

You can start the swarm from the command line using Port forwarding as follows:

Get the Locust URL following the Post Installation notes.

for example:

export LOCUST_URL=

Start / Monitor & Stop the Locust swarm via the web panel or with following commands:


curl -XPOST $LOCUST_URL/swarm -d"locust_count=100&hatch_rate=10"


watch -n 1 "curl -s $LOCUST_URL/stats/requests | jq -r '[.user_count, .total_rps, .state] | @tsv'"


curl $LOCUST_URL/stop