☁️VoltTest Cloud closed beta is now open—Join the waitlist
Skip to main content

Installation

Requirements​

  • PHP 8.2 or higher
  • Laravel 11, 12, or 13
  • ext-pcntl PHP extension (Unix-like systems only)
  • Composer

Install the Package​

composer require volt-test/laravel-performance-testing

The package uses Laravel's auto-discovery, so the service provider and facade are registered automatically.

Publish Configuration​

php artisan vendor:publish --tag=volttest-config

This creates config/volttest.php with all default settings.

Environment Variables​

Add these to your .env file as needed:

# Test defaults
VOLTTEST_VIRTUAL_USERS=10
VOLTTEST_DURATION=1m
VOLTTEST_RAMP_UP=10s

# Base URL (defaults to http://localhost:8000)
VOLTTEST_BASE_URL=http://localhost:8000

# Cloud execution (optional)
VOLTTEST_API_KEY=vt_your_api_key
VOLTTEST_CLOUD_ENABLED=false

# Debug
VOLTTEST_HTTP_DEBUG=false

# Reports
VOLTTEST_SAVE_REPORTS=true

Verify Installation​

Run the following to confirm the package is installed:

php artisan volttest:make --help

You should see the command's help output with available options.

Next Steps​