Locust
Locust is a Python-based load testing tool with a real-time web UI. Write test scenarios in plain Python, launch swarms of simulated users, and monitor results through interactive charts. Stateless single container, no external dependencies.
Services
locust
locustio/locust:2.43.3Locust
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
- Visit your domain -- the Locust web UI opens with no login required
- Set target host -- enter the URL of the service you want to load test
- Configure users -- set the number of simulated users and spawn rate
- Start swarming -- launch the test and monitor requests per second, response times, and failure rates in real time
- 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
Services