Locust

A modern, Python-based load testing framework. Define user behavior in plain Python code, launch thousands of simulated users, and watch real-time metrics through an interactive web dashboard.

What You Can Do After Deployment

1. Visit your domain -- the Locust web UI opens with no login required
2. Set target host -- enter the URL of the service you want to load test
3. Configure users -- set the number of simulated users and spawn rate
4. Start swarming -- launch the test and monitor requests per second, response times, and failure rates in real time
5. Download results -- export test data as CSV for further analysis

Key Features

• Write test scenarios in plain Python -- no XML or DSL
• Real-time web UI with interactive charts
• Requests per second, response time percentiles, and failure tracking
• Supports HTTP, WebSocket, and any Python-accessible protocol
• Lightweight and horizontally scalable
• CSV export for test results
• No volume needed -- fully stateless

Default Locustfile

This template starts with a minimal demo locustfile. Mount your own locustfile to /mnt/locust/locustfile.py or use the web UI to configure tests.

License

MIT -- GitHub | Website