# Install K6 - https://k6.io/docs/getting-started/installation/
# macOS
brew install k6

# Ubuntu/Debian
sudo apt-get install k6

# Windows (Chocolatey)
choco install k6

Running Tests

Smoke Test

One user, basic journey validation.

k6 run simulations/smokeTest.js

Load Test

Ramp up to max users over duration.

BASE_URL=http://localhost:8080 MAX_USERS=5 RAMP_DURATION=60 k6 run simulations/loadTest.js

Stress Test

Incrementally increase users in steps.

BASE_URL=http://localhost:8080 \
  START_USERS=2 \
  USERS_INCREMENT=2 \
  STEPS=2 \
  STEP_DURATION=30 \
  RAMP_DURATION=10 \
  k6 run simulations/stressTest.js

Spike Test

Baseline → spike → baseline.

BASE_URL=http://localhost:8080 \
  BASELINE_USERS=2 \
  BASELINE_DURATION=20 \
  SPIKE_USERS=15 \
  k6 run simulations/spikeTest.js

Endurance Test

Constant load over long duration.

BASE_URL=http://localhost:8080 \
  CONCURRENT_USERS=3 \
  DURATION=300 \
  k6 run simulations/enduranceTest.js

Environment Variables

BASE_URL - API base URL (default: http://localhost:8080)
AUTH_TOKEN - Optional Bearer token for global auth
Test-specific variables documented in each simulation file

Output

Results summary printed to console. For detailed metrics, use K6 output options:

# JSON output
k6 run --out json=results.json simulations/smokeTest.js

# Cloud output (requires K6 Cloud account)
k6 run --out cloud simulations/smokeTest.js

# InfluxDB + Grafana
k6 run --out influxdb simulations/smokeTest.js

Structure

config.js - Shared configuration, headers, checks
scenarios/ - Reusable scenario definitions
simulations/ - Test simulations with load profiles