Installation

Install curl-runner on your system using your preferred package manager or download a pre-built binary.

Copy Markdown

Prerequisites

Bun Runtime

Recommended

curl-runner is optimized for Bun and provides the best performance when used with Bun runtime.

# Install Bun (if not already installed)
curl -fsSL https://bun.sh/install | bash

# Verify Bun installation
bun --version

Installation Methods

Bun Package Manager

Recommended

Install using Bun for optimal performance and compatibility.

bun install -g curl-runner

npm Package Manager

Install using npm if you prefer Node.js ecosystem tools.

npm install -g curl-runner

Pre-built Binary

Download a standalone executable for your platform.

# Pull the Docker image
docker pull curlrunner/curl-runner:latest

# Run tests using Docker
docker run --rm -v "$(pwd)":/workspace curlrunner/curl-runner:latest my-tests.yaml

Verify Installation

After installation, verify that curl-runner is working correctly:

curl-runner --version

Platform Support

Linux

Ubuntu 20.04+, CentOS 8+, Alpine Linux

macOS

macOS 11+ (Intel & Apple Silicon)

Windows

Windows 10+, WSL2 supported

Troubleshooting

Common Issues

Command not found

If you get "curl-runner: command not found", ensure that the installation directory is in your PATH.

# Check if curl-runner is in PATH
which curl-runner

# Add to PATH if needed (replace with your installation path)
export PATH="$PATH:~/.bun/bin"

Permission denied

On Unix systems, you may need to make the binary executable:

chmod +x /path/to/curl-runner