Warp Documentation
Warp is an open-source testing tool for S3-compatible object storage systems. Use Warp to evaluate storage performance, plan capacity, and verify that infrastructure meets application requirements.
What Warp does
Warp measures how your object storage performs using tests that approximate real-world conditions. The tool generates load against your S3 endpoints and reports throughput, latency, and consistency metrics.
When you configure Warp tests, it can simulate various workload patterns, including uploads, downloads, metadata queries, or a mixture of all of them. By configuring tests to simulate your application patterns, Warp can show how your storage behaves under conditions that reflect your use case.
The tool supports both single-machine and distributed testing. For distributed scenarios, multiple clients coordinate to generate aggregate loads that exceed single-machine capabilities. This flexibility allows you to test everything from development systems to production-scale infrastructure.
Common use cases
System administrators use Warp to answer specific questions about their storage infrastructure.
| Use case | What to test | How it helps |
|---|---|---|
| Evaluate new hardware | Test storage systems before deployment using workloads that match your applications | Verify that hardware meets performance requirements and compare configurations or vendors |
| Plan capacity | Run tests with gradually increasing load to identify system limits | Determine maximum sustainable load and identify bottlenecks before they affect production |
| Verify SLA compliance | Execute long-running stability tests under sustained load | Confirm that storage maintains acceptable response times over extended periods |
| Troubleshoot performance issues | Run focused tests on specific operations like uploads, downloads, or metadata queries | Isolate whether problems stem from network, storage, or application layers |
| Validate changes | Test before and after configuration changes or software upgrades | Identify performance improvements or regressions using comparison tools |
Where to install Warp
The baremetal installation runs Warp as a standalone binary on individual systems. Baremetal installation provides methods for both single-machine testing and distributed testing across multiple systems for full network saturation.
Get started
After installation, begin with simple tests to verify connectivity and understand baseline performance.
The Administration section explains how to configure tests for your workload patterns. Start with mixed workload tests to evaluate overall system behavior, then progress to focused tests for specific operations.
The Core Concepts documentation covers test configuration, workload types, and result interpretation. Understanding these fundamentals helps you design meaningful tests and interpret results accurately.
The Reference section provides complete command-line documentation for all Warp options and parameters.
About the project
Warp is a project maintained by MinIO. The source code, issue tracker, and contribution guidelines are available at github.com/minio/warp.
The tool works with any S3-compatible object storage system including MinIO, Amazon S3, Google Cloud Storage, and other compatible implementations.