Docker Images

Use the official RoadRunner image at ghcr.io/roadrunner-server/roadrunner:3.0.0. The application, Nginx, and debugging examples use this release tag.

The 3 and 3.0 tags follow releases in their respective version lines. Use 3.0.0 to select a specific release. Copy the RoadRunner binary into an application image with PHP.

Build the RoadRunner Image

For a custom binary, follow the source installation guide. Build a static Linux rr binary for the target architecture with CGO_ENABLED=0. Put the binary and Dockerfile.rr in the same build directory:

Dockerfile.rr

FROM scratch AS roadrunner
COPY rr /usr/bin/rr

Build the image for the same target platform as your PHP application image:

docker build -f Dockerfile.rr -t roadrunner:v3-local .

roadrunner:v3-local contains the compiled binary. Copy this binary into an application image with PHP. The binary, this image, and the application image must use the same target architecture. Setting Docker --platform does not recompile a binary copied from the host.

To use this custom image, set the first FROM below to roadrunner:v3-local.

Build the Application Image

Here is an example of a Dockerfile that can be used to build a Docker image with RoadRunner for a PHP application:

Note that this example utilizes a folder named app for your application. If your application is located in a different folder, feel free to customize this Dockerfile to suit your needs.

Dockerfile

FROM ghcr.io/roadrunner-server/roadrunner:3.0.0 AS roadrunner

FROM php:8.5-cli-alpine

# https://github.com/mlocati/docker-php-extension-installer
# https://github.com/docker-library/docs/tree/0fbef0e8b8c403f581b794030f9180a68935af9d/php#how-to-install-more-php-extensions
RUN --mount=type=bind,from=mlocati/php-extension-installer:2,source=/usr/bin/install-php-extensions,target=/usr/local/bin/install-php-extensions \
     install-php-extensions @composer-2 opcache zip intl sockets protobuf

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

EXPOSE 8080/tcp

WORKDIR /app

ENV COMPOSER_ALLOW_SUPERUSER=1

# Copy composer files from the app directory to install dependencies
COPY ./app/composer.* .

RUN composer install --optimize-autoloader --no-dev

# Copy application files
COPY ./app .

# Run the RoadRunner server
CMD ["/usr/local/bin/rr", "serve", "-c", ".rr.yaml"]