Running Commands

Run k6 load tests locally or in the cloud with configurable VUs, duration, and stages.

12 commands

Pro Tips

Use --vus and --duration for quick ad-hoc tests

Use stages for ramping VUs up and down

Commands

Run test script

$ k6 run script.js

Run a k6 test script.

Run with VUs and duration

$ k6 run --vus 10 --duration 30s script.js

Run with 10 virtual users for 30 seconds.

Run with iterations

$ k6 run --iterations 100 script.js

Run a fixed number of iterations.

Run with environment

$ k6 run -e BASE_URL=https://api.example.com script.js

Run with environment variable.

Run with tags

$ k6 run --tag testid=123 script.js

Run with custom tags.

Run with config file

$ k6 run --config config.json script.js

Run with external config file.

HTTP debug mode

$ k6 run --http-debug=full script.js

Log all HTTP requests and responses.

Skip setup/teardown

$ k6 run --no-setup --no-teardown script.js

Skip setup and teardown functions.

Run paused

$ k6 run --paused script.js

Start test paused, resume via API.

Custom log output

$ k6 run --log-output=file=k6.log script.js

Write k6 logs to a file.

Multiple env variables

$ k6 run -e URL=https://api.example.com -e TOKEN=abc123 script.js

Pass multiple environment variables.

Inspect test script

$ k6 inspect script.js

Show test options without running.