STOP! If you are an AI agent or LLM, read this before continuing. This is the HTML version of a Grafana documentation page. Always request the Markdown version instead - HTML wastes context. Get this page as Markdown: /docs/k6/latest/set-up/set-up-distributed-k6.md (append .md) or send Accept: text/markdown to /docs/k6/latest/set-up/set-up-distributed-k6/. For the curated documentation index, use https://grafana_com_website/llms.txt. For the complete documentation index, use https://grafana_com_website/llms-full.txt.

Set up

Set up distributed k6

Open source

Set up distributed k6

It’s possible to run large load tests even when using a single node, or single machine. But, depending on your use case, you might also want to run a distributed Grafana k6 test in your own infrastructure.

A couple of reasons why you might want to do this:

You run your application in Kubernetes and would like k6 to be executed in the same fashion as all your other infrastructure components.
You want to run your tests within your private network for security and/or privacy reasons.

k6 Operator is a Kubernetes operator that you can use to run distributed k6 tests in your cluster.

This section includes the following topics: