NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #998 most downloaded on Packagist
RoadRunner command-line tool: downloads the RoadRunner binary and generates its configuration
Latest stable
3.1.0
Last release 23 days ago
30 Oct 2026
Release timing varies
gaps range from 3 weeks to 1.1 years
Nearly every release is documented
notes for 27 of 27 stable releases
Nothing withdrawn
no release was ever pulled
6 years old
27 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
deprecate download-protoc-binary in favour of get-grpc-tools
Your coding agent can read these notes before it upgrades. Set up the MCP server →
generate a configuration that RoadRunner 3 accepts
tcp, websockets, broadcast and reload plugins are removed: RoadRunner 3 does not ship them.Command, Configuration and Downloader namespaces move to Spiral\RoadRunner\Console\Internal\Option, Internal\Configuration and Internal\Downloader, and Environment\Stability, Environment\RoadRunnerVersion and Environment\Environment to Internal\Environment; all of them are internal now. The abstract Spiral\RoadRunner\Console\Command, Command\OptionInterface, Environment\Enum and both Environment\*\Factory classes are removed: the commands extend the Symfony command directly. The commands and Configuration\Generator are final. Environment\Environment::get() takes only the variable name, OperatingSystem::createFromGlobals() takes no arguments, Stability::all() returns a list, and RoadRunnerVersion::PACKAGE_NAME and DEFAULT_CONSTRAINT are private.Spiral\RoadRunner\Console\Archive and Spiral\RoadRunner\Console\Repository namespaces are removed, Version1\StaticRepository included. Command::getRepository() and Command::confirm() are removed, and VersionFilterOption::find() and VersionFilterOption::choices() with them. VersionsCommand is final.get-binary and download-protoc-binary, RR_GITHUB_API_URL must be https://api.github.com or end with /api/v3, and the token for a GitHub Enterprise Server is read from DLOAD_TOKEN_<HOST> (e.g. DLOAD_TOKEN_GHE_EXAMPLE_COM) instead of GITHUB_TOKEN. symfony/console and symfony/http-client 6.4 or newer are required.Support Symfony 8.0 by @Nyholm in https://github.com/roadrunner-php/cli/pull/47 Fixed deprecations
Full Changelog: https://github.com/roadrunner-php/cli/compare/v2.7.1...v2.7.2
Included amd64 into X86-64 mapping
amd64 into X86-64 mappingFull Changelog: https://github.com/roadrunner-php/cli/compare/v2.7.0...v2.7.1
Fix documentation links by @msmakouz in https://github.com/roadrunner-php/cli/pull/45
Full Changelog: https://github.com/roadrunner-php/cli/compare/v2.6.0...v2.7.0
Update dependencies by @msmakouz in https://github.com/roadrunner-php/cli/pull/44
Full Changelog: https://github.com/roadrunner-php/cli/compare/v2.5.0...v2.6.0
Added new --no-config option to GetBinaryCommand, to skip generating config by @acelaya in https://github.com/roadrunner-php/cli/pull/38
Full Changelog: https://github.com/roadrunner-php/cli/compare/v2.4.0...v2.5.0
Added command for RoadRunner config generation by @butschster in https://github.com/spiral/roadrunner-cli/pull/39
Full Changelog: https://github.com/spiral/roadrunner-cli/compare/v2.3.0...v2.4.0
Using the plugin option (shortcut p) you can generate an example of configuration file with the only plugins you need.
Using the plugin option (shortcut p) you can generate an example of configuration file with the only plugins you need.
For example, with http plugin only:
./vendoor/bin/get-binary -p http
http and jobs:
./vendoor/bin/get-binary -p http -p jobs
Available plugins:
by @msmakouz in https://github.com/spiral/roadrunner-cli/pull/30
Allows to install the latest version of the protoc-gen-php-grpc file compatible with your environment (operating system, processor architecture, runtime, etc...).
Just use the following command
./vendor/bin/download-protoc-binary
by @msmakouz in https://github.com/spiral/roadrunner-cli/pull/34
Full Changelog: https://github.com/spiral/roadrunner-cli/compare/v2.2.0...v2.3.0
Exclude deb packages from downloadable binaries by @butschster in https://github.com/spiral/roadrunner-cli/pull/32
Full Changelog: https://github.com/spiral/roadrunner-cli/compare/v2.1.0...v2.2.0
Roadrunner binary repository moved to the new organization - https://github.com/roadrunner-server/roadrunner
Roadrunner binary repository moved to the new organization - https://github.com/roadrunner-server/roadrunner
Starting from the roadrunner-cli v2.1.0 versions of roadrunner binary lower than 2.7.0 are not supported. If you want to use roadrunner lower than 2.7.0 please use previous version of this package.
Full Changelog: https://github.com/spiral/roadrunner-cli/compare/v2.0.14...v2.1.0
Add compatibility with symfony ^6.0
Full Changelog: https://github.com/spiral/roadrunner-cli/compare/v2.0.13...v2.0.14
Fixes problem with downloading roadrunner binary by @butschster in https://github.com/spiral/roadrunner-cli/pull/24
Fix arch autodetection on M1 Mac.
Remove 2.0 alphas from predefined array
Remove RR 1.0 release API requests
Added support for real (internal) and "pretty" (composer-compatible) release tags.
Added support for real (internal) and "pretty" (composer-compatible) release tags.
Fix "Invalid version string" error (#15, #14)
Stop asking to create config file if already exists in current dir
- Add aarch64 alias support
Fix compatibility with symfony ^4.4 LTS components
- Actualize symfony dependecies
- Added arm64 in known arch list
Using minimum stability instead strict stability comparison
Added information about current environment (during installation and get a list of versions)
--stability flag (default: stable)spiral/roadrunner-binary repositorySubsplit CLI tools from spiral/roadrunner-worker 2.0.1
One column per quarter.