Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/gatling/gatling.io-doc/llms.txt

Use this file to discover all available pages before exploring further.

Gatling is a high-performance load testing framework built for developer workflows. Tests are written as code using expressive SDKs in Java, Kotlin, Scala, JavaScript, or TypeScript — making them easy to version, review, and run in CI/CD pipelines. Gatling’s fully asynchronous engine models virtual users as lightweight messages rather than threads, enabling you to simulate tens of thousands of concurrent users with minimal resources.

Quickstart

Get a working load test running in under 5 minutes

Installation

Install Gatling for Java, JavaScript, or other SDKs

Core Concepts

Understand simulations, scenarios, sessions, and injection

HTTP Reference

Complete HTTP protocol scripting reference

Why Gatling?

Gatling combines developer-friendly code authoring with a battle-tested asynchronous engine. Whether you’re testing a REST API, a gRPC service, or a message broker, Gatling gives you precise control over load profiles and detailed metrics out of the box.

Multi-Language SDKs

Write tests in Java, Kotlin, Scala, JavaScript, or TypeScript — choose the language that fits your team

Protocol Breadth

Built-in support for HTTP, gRPC, JMS, MQTT, WebSocket, and SSE

Flexible Load Profiles

Open and closed workload models, ramp-ups, constant rates, step functions, and stress peaks

Rich Assertions

Define pass/fail criteria on response times, percentiles, request counts, and error rates

CI/CD Native

Runs anywhere — Maven, Gradle, SBT, GitHub Actions, GitLab CI, Jenkins, and more

Enterprise Edition

Cloud-managed runs, real-time dashboards, private locations, SSO, and AI-powered analysis

Get Started

1

Install Gatling

Choose your language and install the Gatling SDK via Maven, Gradle, npm, or the demo project. See the Installation guide.
2

Write your first simulation

Define a scenario, configure the HTTP protocol, set an injection profile, and run your first load test. See Your First Simulation.
3

Understand the results

Gatling generates a detailed HTML report with response time percentiles, throughput, and error rates. Learn how to read reports.
4

Integrate with CI/CD

Run Gatling automatically in your pipeline and enforce quality gates with assertions. See the GitHub Actions or GitLab CI guides.

Explore the Docs

Scripting Reference

Complete SDK reference for HTTP, gRPC, JMS, MQTT, WebSocket, and session management

Guides

How-to guides for realistic tests, debugging, CI/CD, and common use cases

Enterprise Edition

Run and manage tests at scale with Gatling Enterprise’s web UI and cloud infrastructure

Integrations

Build tools, CI/CD platforms, observability tools, and Postman import
Community support: Ask questions and get help at community.gatling.io.
Enterprise support: Contact the team directly from your cloud.gatling.io workspace.

Build docs developers (and LLMs) love