Installation

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 releases page.

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.

Here is an example of usage:

FROM php:8.x-cli
COPY --from=ghcr.io/roadrunner-server/roadrunner:2025.X.X /usr/bin/rr /usr/local/bin/rr

# Install and configure your application
# ...

CMD rr serve -c .rr.yaml

Don't forget to replace 2025.X.X with the 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

The server binary will be available at the root of your project.

The php-curl and php-zip extensions are required to download RoadRunner automatically. The php-sockets extension needs to be installed to run RoadRunner. Check your installed extensions with php --modules.

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 the desired version of RoadRunner.

macOS package using Homebrew:

brew install roadrunner

Windows using Chocolatey:

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.

1. RoadRunner — Configuration.

2. Developer Mode.