---
title: "Installation"
description: "Install curl-runner on your system using your preferred package manager or download a pre-built binary."
category: "Getting Started"
keywords:
  - curl-runner
  - http
  - api
  - testing
  - installation
  - yaml
  - request
  - cli
  - bun
  - npm
slug: "/docs/installation"
toc: true
date: "2026-06-10T19:35:03.551Z"
lastModified: "2026-06-10T19:35:03.551Z"
author: "alexvcasillas"
authorUrl: "https://github.com/alexvcasillas/curl-runner"
license: "MIT"
nav:
  label: "Installation"
  category: "Getting Started"
tags:
  - documentation
  - getting-started
og:
  title: "Installation - curl-runner Documentation"
  description: "Install curl-runner on your system using your preferred package manager or download a pre-built binary."
  type: "article"
  image: "/og-image.png"
schema:
  "@context": "https://schema.org"
  "@type": "TechArticle"
  headline: "Installation"
  description: "Install curl-runner on your system using your preferred package manager or download a pre-built binary."
  datePublished: "2026-06-10T19:35:03.551Z"
  dateModified: "2026-06-10T19:35:03.551Z"
---

# Installation

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

## Prerequisites

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

### Bun Runtime

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

# Verify Bun installation
bun --version
```

## Quick Install

The fastest way to install `curl-runner`. Downloads the latest pre-compiled binary, verifies checksum, and adds to PATH automatically.

### Linux / macOS

### Windows (PowerShell)

```powershell
irm https://www.curl-runner.com/install.ps1 | iex
```

### No Prerequisites

The installer downloads a standalone binary with Bun bundled. No runtime dependencies required.

```bash
curl -fsSL https://www.curl-runner.com/install.sh | bash
```

```powershell
irm https://www.curl-runner.com/install.ps1 | iex
```

## Package Managers

Install using Bun for optimal performance and compatibility.

### Bun Package Manager

### npm Package Manager

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

```bash
npm install -g @curl-runner/cli
```

### Prerequisites

**For npm/yarn/pnpm installation:** Bun runtime must be installed on your system.

### Pre-compiled Binaries

Download standalone executables with no dependencies required.

```bash
# Download the binary (replace VERSION with actual version)
curl -LO https://github.com/alexvcasillas/curl-runner/releases/latest/download/curl-runner-cli-VERSION-linux-x64.tar.gz

# Extract the archive
tar -xzf curl-runner-cli-VERSION-linux-x64.tar.gz

# Make executable
chmod +x curl-runner

# Move to PATH (optional)
sudo mv curl-runner /usr/local/bin/

# Verify installation
curl-runner --version
```

```bash
bun install -g @curl-runner/cli
```

```bash
npm install -g @curl-runner/cli
```

```bash
# Download the binary (replace VERSION with actual version)
curl -LO https://github.com/alexvcasillas/curl-runner/releases/latest/download/curl-runner-cli-VERSION-linux-x64.tar.gz

# Extract the archive
tar -xzf curl-runner-cli-VERSION-linux-x64.tar.gz

# Make executable
chmod +x curl-runner

# Move to PATH (optional)
sudo mv curl-runner /usr/local/bin/

# Verify installation
curl-runner --version
```

```powershell
# Download the binary (replace VERSION with actual version)
Invoke-WebRequest -Uri "https://github.com/alexvcasillas/curl-runner/releases/latest/download/curl-runner-cli-VERSION-windows-x64.zip" -OutFile "curl-runner.zip"

# Extract the archive
Expand-Archive -Path curl-runner.zip -DestinationPath .

# Add to PATH (optional - run as Administrator)
$env:PATH += ";$PWD"

# Verify installation
curl-runner --version
```

```bash
# Download checksums file
curl -LO https://github.com/alexvcasillas/curl-runner/releases/latest/download/SHA256SUMS.txt

# Verify the download
sha256sum -c SHA256SUMS.txt --ignore-missing
```

```bash
# Download checksums file
curl -LO https://github.com/alexvcasillas/curl-runner/releases/latest/download/SHA256SUMS.txt

# Verify the download
shasum -a 256 -c SHA256SUMS.txt
```

```powershell
# Download checksums file
Invoke-WebRequest -Uri "https://github.com/alexvcasillas/curl-runner/releases/latest/download/SHA256SUMS.txt" -OutFile "SHA256SUMS.txt"

# Get file hash
$hash = (Get-FileHash -Algorithm SHA256 curl-runner-cli-VERSION-windows-x64.zip).Hash

# Compare with expected hash from SHA256SUMS.txt
# (Manually compare the hash output)
```

## Verify Installation

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

```bash
curl-runner --version
```

## Platform Support

## Troubleshooting

### Common Issues

```bash
# 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"
```

```bash
chmod +x /path/to/curl-runner
```

## Next Steps

### Installation Guide

Detailed installation instructions for all platforms

[Get Started](/docs/installation)

### YAML Structure

Learn the YAML configuration format and options

[Learn More](/docs/yaml-structure)

### Examples

Browse real-world examples and use cases

[Explore](/docs/examples/basic)