RoadRunner
  • 🟠General
    • What is RoadRunner?
    • Features
    • Quick Start
    • Installation
    • Configuration
    • Contributing
    • Upgrade and Compatibility
  • 👷PHP Worker
    • Worker
    • Workers pool
    • Developer mode
    • Code Coverage
    • Debugging
    • Environment
    • Manual workers scaling
    • Auto workers scaling
    • RPC
  • 🟢Customization
    • Building RR with a custom plugin
    • Integrating with Golang Apps
    • Writing a Middleware
    • Writing a Jobs Driver
    • Writing a Plugin
    • Events Bus
  • 🔌Plugins
    • Intro into Plugins
    • Centrifuge (WebSockets)
    • Service (Systemd)
    • Configuration
    • Server
    • Locks
    • gRPC
    • TCP
  • 🌐Community Plugins
    • Intro into Community Plugins
    • Circuit Breaker
    • SendRemoteFile
    • RFC 7234 Cache
  • 🔵App Server
    • Production Usage
    • RoadRunner with NGINX
    • RR as AWS Lambda
    • Docker Images
    • CLI Commands
    • Systemd
  • 🔐Key-Value
    • Intro into KV
    • Memcached
    • In-Memory
    • BoltDB
    • Redis
  • 📦Queues and Jobs
    • Intro into Jobs
    • Google Pub/Sub
    • Beanstalk
    • In-Memory
    • RabbitMQ
    • BoltDB
    • Kafka
    • NATS
    • SQS
  • 🕸️HTTP
    • Intro into HTTP
    • Headers and CORS
    • Proxy IP parser
    • Static files
    • X-Sendfile
    • Streaming
    • gzip
  • 📈Logging and Observability
    • OpenTelemetry
    • HealthChecks
    • Access Logs
    • AppLogger
    • Metrics
    • Grafana
    • Logger
  • 🔀Workflow Engine
    • Temporal.io
    • Worker
  • 🧩Integrations
    • Migration from RRv1 to RRv2
    • Spiral Framework
    • Yii
    • Symfony
    • Laravel
    • ChubbyPHP
  • 🧪Experimental Features
    • List of the Experimental Features
  • 🚨Error codes
    • CRC validation failed
    • Allocate Timeout
  • 📚Releases
    • v2025.1.1
    • v2025.1.0
    • v2024.3.5
    • v2024.3.4
    • v2024.3.3
    • v2024.3.2
    • v2024.3.1
    • v2024.3.0
Powered by GitBook
On this page
  • Pre-built Binaries
  • Docker
  • Composer
  • Debian Package
  • macOS package using Homebrew:
  • Windows using Chocolatey:
  • CURL
  • What's Next?

Was this helpful?

Edit on GitHub
  1. General

Installation

PreviousQuick StartNextConfiguration

Last updated 1 year ago

Was this helpful?

There are several ways to install RoadRunner, depending on your needs and preferences.

Pre-built Binaries

The simplest way to get the latest version of RoadRunner is to download one of the pre-built release binaries, which are available for various operating systems, including macOS, Linux, FreeBSD, and Windows. You can find these binaries on the GitHub .

To install RoadRunner, just download the appropriate archive from the releases page and extract it into your desired application directory.

Docker

If you prefer to use RoadRunner inside a Docker container, you can use the official RoadRunner Docker image ghcr.io/roadrunner-server/roadrunner:latest.

More information about available tags can be found .

Here is an example of usage

FROM ghcr.io/roadrunner-server/roadrunner:2024.X.X AS roadrunner
FROM php:8.x-cli

COPY --from=roadrunner /usr/bin/rr /usr/local/bin/rr

# Install and configure your application
# ...

CMD rr serve -c .rr.yaml

Don't forget to replace 2024.X.X with a desired version of RoadRunner.

Composer

If you use Composer to manage your PHP dependencies, you can install the spiral/roadrunner-cli package to download the latest version of RoadRunner to your project's root directory.

Install the package

composer require spiral/roadrunner-cli

Run the following command to download the latest version of RoadRunner

./vendor/bin/rr get-binary

Server binary will be available at the root of your project.

PHP's extensions php-curl and php-zip are required to download RoadRunner automatically. PHP's extensions php-sockets need to be installed to run roadrunner. Check with php --modules your installed extensions.

Debian Package

For Debian-based operating systems such as Ubuntu, Mint, and MX, you can download the .deb package from the RoadRunner GitHub releases page and install it using dpkg.

Just run the following commands

wget https://github.com/roadrunner-server/roadrunner/releases/download/v2024.X.X/roadrunner-2024.X.X-linux-amd64.deb
sudo dpkg -i roadrunner-2024.X.X-linux-amd64.deb

Don't forget to replace 2024.X.X with a desired version of RoadRunner.

brew install roadrunner
choco install roadrunner

CURL

You can also install RoadRunner using curl and the download-latest.sh script from the RoadRunner GitHub repository.

Just run the following commands

curl --proto '=https' --tlsv1.2 -sSf  https://raw.githubusercontent.com/roadrunner-server/roadrunner/master/download-latest.sh | sh

What's Next?

After you have installed RoadRunner, you can proceed to the next steps and configure it for your needs.

macOS package using :

Windows using :

.

.

🟠
releases page
here
Homebrew
Chocolatey
RoadRunner — Configuration
Developer Mode