📦 Installation Guide

Get HTTP File Runner installed on your system in seconds

🚀 Quick Install Script

Recommended

One-command installation that automatically detects your platform, downloads the latest release, and adds it to your PATH.

Linux & macOS

curl -fsSL https://christianhelle.com/httprunner/install | bash

Windows (PowerShell)

irm https://christianhelle.com/httprunner/install.ps1 | iex

What the script does:

  • ✅ Automatically detects your platform and architecture
  • 📥 Downloads the latest release from GitHub
  • 📁 Installs the binary to an appropriate location
  • 🛣️ Adds it to your PATH (if desired)
  • ✨ Verifies the installation

Cargo (Crates.io)

Rust
cargo install httprunner

For users with Rust tooling installed. Compiles and installs the latest version from Crates.io.

  • ✅ Always get the latest version
  • ✅ Automatically installs to ~/.cargo/bin/
  • ✅ Optimized for your system architecture
  • ⚙️ Requires Rust 1.70+ from rustup.rs

Manual Download

📥 Download from GitHub Releases

Download the appropriate binary for your platform and extract to your PATH.

  • 🐧 Linux x86_64: httprunner-linux-x86_64.tar.gz
  • 🍎 macOS x86_64: httprunner-macos-x86_64.tar.gz
  • 🍎 macOS ARM64: httprunner-macos-aarch64.tar.gz
  • 🪟 Windows x86_64: httprunner-windows-x86_64.zip

Snap Store

sudo snap install httprunner

Easy installation on Linux systems with snap support.

Build from Source

git clone https://github.com/christianhelle/httprunner.git
cd httprunner
cargo build --release

Requires Rust 1.70 or later. Gives you the latest features and customization options.

Docker

docker pull christianhelle/httprunner

Run in a containerized environment without installing dependencies.

Usage:

docker run --rm -v $(pwd):/workspace christianhelle/httprunner requests.http

🚀 GitHub Codespaces

Development
🌐 Open in GitHub Codespaces

Start developing immediately with a pre-configured cloud development environment. Includes Zig 0.15.1 and VS Code extensions.

What's included:

  • ✅ Zig 0.15.1 pre-installed
  • ✅ PowerShell Core for build scripts
  • ✅ VS Code Zig extension
  • ✅ Language server (ZLS) configured
  • ✅ All project dependencies ready

Local Development:

Clone the repository and open in VS Code with the Dev Containers extension to use the same environment locally.

🔧 Troubleshooting

Command not found after installation

If you get a "command not found" error after installation:

  1. Restart your terminal/command prompt
  2. Check if the installation directory is in your PATH
  3. For Linux/macOS, add to your shell profile: export PATH="$PATH:/path/to/httprunner"
  4. For Windows, check "Environment Variables" in System Properties

Permission denied errors

If you encounter permission errors:

  • Linux/macOS: Try installing to a user directory: INSTALL_DIR=$HOME/.local/bin
  • Windows: Run PowerShell as Administrator or install to a user directory

Download failures

If downloads fail:

  • Check your internet connection
  • Try the manual download method
  • Check if your firewall or proxy is blocking the download

✅ Verify Installation

After installation, verify that httprunner is working correctly:

# Check version httprunner --version # Show help httprunner --help # Test with a simple request echo "GET https://httpbin.org/get" > test.http httprunner test.http

🎯 Next Steps

📚 Read the Guide

Learn how to write and execute HTTP requests

📖 API Reference

Complete command-line reference and examples

🔍 View Examples

Check out sample .http files to get started