This page documents installing Warp on baremetal systems.
Warp runs as a standalone binary that provides S3 testing capabilities for evaluating storage system performance.
Prerequisites
Before installing Warp, verify that your system meets the following requirements.
Network access to the S3-compatible storage endpoints you plan to test.
Valid S3 credentials including an access key and secret key for the target storage system.
Install Warp
Warp provides pre-compiled binaries for common operating systems and architectures.
Select the tab for your system to download and install the appropriate binary.
Install Warp on 64-bit Linux systems (Intel/AMD processors).
The output shows the installed Warp version and build information.
Note: macOS typically blocks unsigned binaries from running.
If the command fails, go to System Settings, then Privacy and Security.
Scroll to the Security section and select Allow Anyway for the Warp application.
Install Warp on macOS systems with Apple Silicon (M1/M2/M3) processors.
The output shows the installed Warp version and build information.
Note: macOS typically blocks unsigned binaries from running.
If the command fails, go to System Settings, then Privacy and Security.
Scroll to the Security section and select Allow Anyway for the Warp application.
Move the binary to a directory in your PATH.
For system-wide installation, use an administrator PowerShell:
Move-Itemwarp.exeC:\Windows\System32\
Alternatively, place it in a user directory like C:\Users\YourUsername\bin\ and add that directory to your PATH.
Verify the installation
Confirm that Warp installed correctly:
warp--version
The output shows the installed Warp version and build information.
Run Your First Test
After installation, test Warp functionality.
The following command runs a basic mixed workload test against your S3-compatible storage:
warp put --host s3.example.com --access-key YOUR_ACCESS_KEY --secret-key YOUR_SECRET_KEY --duration 5m
Replace s3.example.com with your actual S3 endpoint.
Replace YOUR_ACCESS_KEY and YOUR_SECRET_KEY with your valid credentials.
You can alternatively export credentials using environment variables.
See the Environment variables for exact variable names and usage.
The test runs for five minutes and displays throughput and latency metrics.
Successful completion confirms that Warp can connect to your storage system and perform test operations.
Next steps
After installing Warp, proceed to the Administration section to learn about test configuration and test types.
Review the Core Concepts documentation to understand test configuration, workload types, and result interpretation.
For distributed benchmarking scenarios requiring multiple client machines, see the Distributed benchmarking documentation.
Consult the Reference section for complete command-line options and detailed parameter descriptions.