NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #884 most downloaded on Packagist
RoadRunner: High-performance PHP application server and process manager written in Go and powered with plugins
Latest stable
v2025.1.15
Last release 1 months ago
21 Oct 2026
Release timing varies
gaps range from 2 weeks to 4 months
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
9 years old
272 releases · first in 2018
Drag across the ruler to compare, or tap a release to open it.
🐛 CVE Fixes: Updated Go toolchain to 1.26.4 to resolve CVE-2026-42504. Note: fiber is only used transitively by the fileserver plugin, BUG #2355 (than…
🚀 v2025.1.15 🚀
🎯 Core
🐛 CVE Fixes: Updated Go toolchain to 1.26.3 and bumped github.com/gofiber/fiber/v2 to v2.52.13 to resolve CVE-2026-33811, CVE-2026-33814, CVE-2026-398…
Your coding agent can read these notes before it upgrades. Set up the MCP server →
🚀 v2025.1.14 🚀
🎯 Core
🧰 Plugins
🧪 Temporal
🐛 CVE Fixes: Updated dependencies and Go version to 1.26.2 to resolve CVE-2026-32280 and CVE-2026-39883 (go/stdlib), CHORE (thanks @rebecca-canyon)
1.26.2 to resolve CVE-2026-32280 and CVE-2026-39883 (go/stdlib), CHORE (thanks @rebecca-canyon)🐛 CVE Fix (deps): Updated google.golang.org/grpc to v1.79.3 to resolve CVE-2026-33186 — a server-side authorization bypass where malformed :path heade…
google.golang.org/grpc to v1.79.3 to resolve CVE-2026-33186 — a server-side authorization bypass where malformed :path headers could circumvent path-based restricted deny rules in gRPC interceptors, CHORE (thanks @rebecca-canyon)🐛 OTEL Semconv: Fixed a regression where the OpenTelemetry plugin failed to start due to conflicting semconv Schema URLs (v1.39.0 vs v1.40.0); updated
otel pluginv1.39.0 vs v1.40.0); updated semconv to v1.40, BUG (thanks @dmitryuk)🐛 CVE Fixes (deps): Updated Go packages to resolve CVE-2026-27141 and CVE-2026-25882, Issue (thanks @Orrison)
grpc plugin** (globstar/recursive) and brace expansion {pattern1,pattern2} in grpc.proto configuration paths, FR (thanks @Nyholm)🐛 Gzip Middleware: Fixed a regression where responses could be encoded with zstd after upgrading to v2025.1.7; the middleware now enforces gzip-only c
gzip middlewarezstd after upgrading to v2025.1.7; the middleware now enforces gzip-only compression BUG (thanks @dmitryuk)🐛 Go Version: Updated minimum Go version to 1.26 to address CVE-2025-61726 in go/stdlib BUG (thanks @Orrison)
1.26 to address CVE-2025-61726 in go/stdlib BUG (thanks @Orrison)✨ Go Version: Updated minimum Go version to 1.25.5.
1.25.5.✨ SIGUSR2 Signal Support: Added support for the SIGUSR2 signal on Unix-like systems to enable graceful process restarts. When the configuration file i
SIGUSR2 signal on Unix-like systems to enable graceful process restarts. When the configuration file is a symlink, RoadRunner will properly re-read the configuration from the symlink target after restart FR (thanks @koren88)1.25.4.v2025.1.5 with an updated template that pinned third-party dep tablewriter that caused problems when building RR.✨ Fileserver Plugin: The Fileserver plugin has been restored to the standard bundle because of the resolution of all CVEs in its dependency, GoFiber.
GoFiber.automaxprocs library from Uber has been removed, as Go 1.25 now includes this functionality natively.v2025.1.4 with an updated template that removed the automaxprocs dependency.✨ Support for the NO_PROXY environment variable to disable proxy usage FR (thanks @jur3)
Temporal pluginNO_PROXY environment variable to disable proxy usage FR (thanks @jur3)Kafka driverGoFiber, has had too many CVEs in recent months.✨ Support activity pause response and Timers summary.
Temporal plugin🐛 Null pointer exception when using KV plugin without Redis driver, BUG (thanks @Orrison)
KV plugin:🚨 Security: address CVE-2025-22871 in the rr package to resolve critical audit findings, rr#2166 (thanks @Orrison)
v2025.1.1 instead of this release if you're using KV plugin.v2024Kafka driver:Jobs plugin:AMQP driver:gRPC plugin:grpc@v1.72.0 and new List healthcheck method, grpc#2162 (thanks @matthewhartstonge)Redis driver:rr package to resolve critical audit findings, rr#2166 (thanks @Orrison)🧑🏭: Do not require a certificate and key for TLS if a Root CA is provided, FR, (thanks @AtCliffUnderline)
Kafka driver:🐛: Segfault on some rare error unpacking conditions, BUG, (thanks @cv65kr)
gRPC plugin:exec_timeout), PR, (thanks @AleksandrKosovS)🔥: Support for the Upsert Memo command: FR
RoadRunner-Temporal plugin:🐛: Support all encoding (not only UTF-8) for the HTTP plugin payloads, BUG, (thanks @GityaMan)
http plugin:RoadRunner-Temporal plugin:gRPC (PHP) plugin:🧑🏭: All plugins were updated (security fixes).
Jobs plugin:RoadRunner-Temporal plugin:disable_activity_workers option to disable PHP activity pool entirely: FP. (thanks @cv65kr)SQS plugin was significantly reworked without major breaking changes, please, read the updated documentation carefully. RoadRunner-Temporalplugin now…
Meet the new RoadRunner release! This time we have a lot of new features, improvements, and bug fixes. Let's dive in! In this realse we have added a new feature called Auto Workers Scaling. This feature allows users to scale their RoadRunner workers automatically, up to 100 additional workers. SQS plugin was significantly reworked without major breaking changes, please, read the updated documentation carefully. RoadRunner-Temporalplugin now supports API-Keys (which would be added via our SDK-PHP and documentated in it as well).
OTEL plugin:In-Memory KV driver:Status plugin:Symfony integration:Redis driver:SQS driver:NOTE: The default values for SQS now use short polling. Make sure you inspect your value for wait_time_seconds if you want to use long polling.Nats driver:Config plugin:Server plugin:server.on_init.exit_on_error to stop RoadRunner when on_init error occured: FR, (thanks @wizardist)RabbitMQ (AMQP) driver:Locks plugin:forceRelease method, removed requirement for input ID BUG, (thanks @fugikzl)Metrics plugin:Velox:SQS driver and reworking the whole JSON schema across all plugins (which is actually HUGE).Metrics and RoadRunner-Temporal plugins.Redis plugin.🔥: Several improvements by @devnev: Do not set Endpoint and Headers for gRPC if they're empty: PR, Support standard OTEL exporter protocol environment
OTEL plugin:Endpoint and Headers for gRPC if they're empty: PR, Support standard OTEL exporter protocol environment variables: PR. (thanks @devnev)RoadRunner-Temporal plugin:AMQP driver:redial_timeout was not respected when dynamically creating pipeline. BUG, (thanks @algirdasci)Velox Dockerfile).😭 Our Go-SDK was deprecated and split into separate packages. Read more in the Upgrade guide.
We are introducing a new term in the RoadRunner community — Community plugins. If you have a brilliant idea for the http middleware or JOBS driver or even a new plugin - feel free to check our Customization tutorials, create and notify us about your plugin.
RoadRunner now supports the Google Pub/Sub queues. Currently, this driver is released in BETA and has a few limitations which you may find in the docs
AMQP and Kafka JOBS driversThanks to our PHP team, KV now has AsyncStorageInterface support which makes your experience with the KV plugin even faster.
Feel free to read the technical details here: link
Jobs driver example for the Jobs plugin.
More info here: link.[roadrunner]
# ref -> reference, tag, commit or branch
ref = "v2024.2.0"
# the debug option is used to build RR with debug symbols to profile it with pprof
[debug]
enabled = false
## Rest is the same ....
Now, there is no need to include linker flags, and buildtime + build version would be inherited automatically.
If you need to debug your binary, please, use the debug option set to true.
🐛: Fix k8s-related problem, when status was not available during the graceful shutdown process: BUG. (thanks @cv65kr)
Status plugin:JOBS plugin:ACK, NACK, and REQUEUE operations for the JOBS drivers. PHP SDK will be updated soon. FR, (thanks @shieldz80)v2024.2.0) and currently don't have restrictions on where to put the included config. Keep in mind that the path for the included configurations is calculated from the working directory of the RoadRunner process. FR🐛: Fix Local activities executed on the Workflow PHP Worker instead of the Activity PHP Worker: BUG. With this fix, LA performance should see a signif
Temporal plugin:🔥: Deprecate RR_* env variables prefix. This was an undocumented feature which caused confusion, because any configuration value might be automaticall…
RR core:RR_* env variables prefix. This was an undocumented feature which caused confusion, because any configuration value might be automatically replaced (without using env in the configuration) with a matching RR_* environment variable, PR.Temporal plugin:continue_as_new_suggested for the PHP Worker: PR.KafkamaxPollRecords from 10k to 100, PR.Endure container:v1.22.4.Worker:RR_VERSION env to the Environment class: PR, (thanks @Kaspiman)🔥: Currently in a polishing phase, the new plugin will be released as part of the v2024.2.0. Stay tuned! (thanks @cv65kr)
google-pub-sub:v2024.2.0. Stay tuned! (thanks @cv65kr)gRPC plugin:OTEL plugin:RR core plugin:workers/reset commands don't respect default config values: BUG, (thanks @r4m-alexd)🐛 Bug: Fix for the NPE on types check: BUG, (thanks @cto-asocial)
🔥 Use protobuf encoded payloads to prevent field reordering and JSON escaped symbols.
HTTP plugin:protobuf encoded payloads to prevent field reordering and JSON escaped symbols.Kafka driver:SDK:max_jobs option and all the workers restarted at the same time. This feature is enabled automatically. (thanks @Kaspiman)🔥 Add support for the NotifyChannelState centrifuge API.
Centrifuge plugin:NotifyChannelState centrifuge API.Temporal plugin:since log entries are now always shown as milliseconds, FR, (thanks @dmitryuk).🐛️ Check the connection properly before attempting to send a request: PR
Centrifuge plugin:OTEL plugin:endpoint and headers: BUG. Update docs on OTEL env usage: Docs, (thanks @fasdalf and @arku31).HTTP plugin:200 instead of 500 in debug mode if PHP code fails: BUG, (thanks @Volonda).🐛️ Stop handler (worker->stop()) was returned (breaking change fix) FIX, (thanks @Zylius)
SDK bugfixes:worker->stop()) was returned (breaking change fix) FIX, (thanks @Zylius)🐛️ Streaming responses can experience a lock-up when the client disconnects early, BUG, (thanks @segrax)
HTTP pluginSQS JOBS driverService pluginServer pluginRedis KV driver🔥 Experimental HTTP3 server, FR, docs: link, (thanks @cv65kr & @cidious)
HTTP plugingRPC plugingRPC plugin: FR, docs: link (thanks @rauanmayemir)Beanstalk driverVelox🔥 Re-enable HTTP health and readiness checks via regular endpoints /health and /ready.
gRPC plugin:/health and /ready.AMQP driver:List (Golang []any), BUG, (thanks @iborysenko).Push method with delays, BUG, (thanks @fereron).🔥 Add support for the arm64 deb packages: FR, (thanks @stevenbrookes)
arm64 deb packages: FR, (thanks @stevenbrookes)🔥 Add the ability to include .env files in the configuration (experimental feature): Docs, (thanks @OO00O0O).
.env files in the configuration (experimental feature): Docs, (thanks @OO00O0O).✒️ Experimental features: Add support for the experimental features: Docs.
origin: FR, Docs, (thanks @orlandothoeny)🐛 RR Core: Fix mistakenly removed RPC endpoint: ISSUE, (thanks @Kaspiman)
🐛 Temporal: Fix incorrect log entry: ISSUE, (thanks @roxblnfk)
🧑🏭 Dependencies: update project dependencies (including CVE in Go libraries).
✒️ sdnotify support: FR, (thanks @Kaspiman), Docs: link
routing_key in the JOBS payload: FR, (thanks @rauanmayemir)service:
schedule:run:
command: "bin/console schedule:run"
process_num: 1
exec_timeout: 0s
remain_after_exit: true
service_name_in_log: false
restart_sec: 60
user: www-data # <---------- [NEW]
group: www-data # <---------- [NEW]
Worker example:
<?php
require __DIR__ . '/vendor/autoload.php';
use Spiral\RoadRunner;
ini_set('display_errors', 'stderr');
require __DIR__ . "/vendor/autoload.php";
$worker = RoadRunner\Worker::create();
$http = new RoadRunner\Http\HttpWorker($worker);
$read = static function (): Generator {
foreach (\file(__DIR__ . '/test.txt') as $line) {
try {
yield $line;
} catch (Spiral\RoadRunner\Http\Exception\StreamStoppedException) {
// Just stop sending data
return;
}
}
};
try {
while ($req = $http->waitRequest()) {
$http->respond(200, $read());
}
} catch (\Throwable $e) {
$worker->error($e->getMessage());
}
103 Early Hints via streamed response: FR, (thanks @azjezz)Worker example:
<?php
use Spiral\RoadRunner;
ini_set('display_errors', 'stderr');
require __DIR__ . "/vendor/autoload.php";
$worker = RoadRunner\Worker::create();
$http = new RoadRunner\Http\HttpWorker($worker);
$read = static function (): Generator {
$limit = 10;
foreach (\file(__DIR__ . '/test.txt') as $line) {
foreach (explode('"', $line) as $chunk) {
try {
usleep(50_000);
yield $chunk;
} catch (Spiral\RoadRunner\Http\Exception\StreamStoppedException $e) {
// Just stop sending data
return;
}
if (--$limit === 0) {
return;
}
}
}
};
try {
while ($req = $http->waitRequest()) {
$http->respond(103, '', headers: ['Link' => ['</style111.css>; rel=preload; as=style'], 'X-103' => ['103']], endOfStream: false);
$http->respond(200, $read(), headers: ['X-200' => ['200']], endOfStream: true); // your regular response
}
} catch (\Throwable $e) {
$worker->error($e->getMessage());
}
.rr.yaml configuration: FR, (thanks @nunomaduro)
First argument should be a command (executable) and the rest of the arguments are passed to the command as arguments.version: "3"
server:
command: ["php", "../../php_test_files/client.php echo pipes"]
relay: "pipes"
relay_timeout: "20s"
version: "3"
server:
command:
- "php"
- "../../php_test_files/client.php echo pipes"
relay: "pipes"
relay_timeout: "20s"
./rr jobs list/stop/resume commands: PR, (thanks @gam6itko).✒️ Support for a custom routing_key in the JOBS payload: FR, (thanks @rauanmayemir, @butschster)
routing_key in the JOBS payload: FR, (thanks @rauanmayemir, @butschster)✒️ Add support for the Worker Versioning: FR
✒️ Service plugin: Support for the user/group per-service: FR, (thanks @Kaspiman)
service:
schedule:run:
command: "bin/console schedule:run"
process_num: 1
exec_timeout: 0s
remain_after_exit: true
service_name_in_log: false
restart_sec: 60
user: www-data # <---------- [NEW]
group: www-data # <---------- [NEW]
sdnotify support: FR, (thanks @Kaspiman)<?php
require __DIR__ . '/vendor/autoload.php';
use Spiral\RoadRunner;
ini_set('display_errors', 'stderr');
require __DIR__ . "/vendor/autoload.php";
$worker = RoadRunner\Worker::create();
$http = new RoadRunner\Http\HttpWorker($worker);
$read = static function (): Generator {
foreach (\file(__DIR__ . '/test.txt') as $line) {
try {
yield $line;
} catch (Spiral\RoadRunner\Http\Exception\StreamStoppedException) {
// Just stop sending data
return;
}
}
};
try {
while ($req = $http->waitRequest()) {
$http->respond(200, $read());
}
} catch (\Throwable $e) {
$worker->error($e->getMessage());
}
103 Early Hints via streamed response: FR, (thanks @roxblnfk).rr.yaml configuration: FR, (thanks @nunomaduro)version: "3"
server:
command: ["php", "../../php_test_files/client.php echo pipes"]
relay: "pipes"
relay_timeout: "20s"
version: "3"
server:
command:
- "php"
- "../../php_test_files/client.php echo pipes"
relay: "pipes"
relay_timeout: "20s"
First argument should be a command (executable) and the rest of the arguments are passed to the command as arguments.
./rr jobs list/stop/resume commands: PR, (thanks @gam6itko).Special thanks for this beta-release to our awesome PHP team: @butschster, @roxblnfk, @wolfy-j and @msmakouz ❤️
🐛 JOBS plugin: Fix typo in the RPC span name: PR, (thanks @Kaspiman).
RPC span name: PR, (thanks @Kaspiman).idleTTL state: BUG, (thanks @Aleksa1996).🐛 NATS driver: Segfault when sending job via third-party sender without consume_all option set to true: BUG, (thanks @KernelMrex).
consume_all option set to true: BUG, (thanks @KernelMrex).on_init option: BUG, (thanks @Kaspiman).allowed_* options with spaces: BUG, (thanks @gam6itko).✒️ Kafka driver: Support for the SCRAM-SHA-256 and SCRAM-SHA-512 SASL mechanisms: FR, (thanks @Azomas)
SCRAM-SHA-256 and SCRAM-SHA-512 SASL mechanisms: FR, (thanks @Azomas)v2023, v2023.x and with bugfix: v2023.x.x. The latest tag points to the latest stable release. All rc, beta, alpha releases will no longer be tagged with latest.after_init option. This is a new server option and, like on_init, can contain any custom command to be fired after each pool of workers is initialized. For example, if you have 2 plugins: http and grpc, the after_init command would be fired twice: FR, (thanks @rauanmayemir).TLS transport named amqps: FR, (thanks @marcosraudkett)http://<status_plugin_host>:<port>/ready(health)?plugin=jobs, PR, (thanks @Kaspiman)history_len to the PHP worker and get the PHP-SDK version to pass to the Temporal server.ttl/wait_ttl value passed to RR is now treated as microseconds. There is no configuration for this plugin, it is bundled with RR.timeout_stop_sec. RR will wait for the specified amount of time (but not more than endure.graceful_period) for the process to stop, FR, (thanks @asanikovich)process_num value passed via RPC: BUG, (thanks @asanikovich)Nothing published for this version
Nothing published for this version
DOCKER IMAGES AVAILABLE UNDER THE `2023.2.0-beta.3` TAG
DOCKER IMAGES AVAILABLE UNDER THE 2023.2.0-beta.3 TAG
SCRAM-SHA-256 and SCRAM-SHA-512 SASL mechanisms: FR, (thanks @Azomas)v2023, v2023.x and with bugfix: v2023.x.x. The latest tag points to the latest stable release. All rc, beta, alpha releases will no longer be tagged with latest.after_init option. This is a new server option and, like on_init, can contain any custom command to be fired after each pool of workers is initialized. For example, if you have 2 plugins: http and grpc, the after_init command would be fired twice: FR, (thanks @rauanmayemir).TLS transport named amqps: FR, (thanks @marcosraudkett)🐛 KV plugin: Correct plugin startup order: PR, (thanks @ekisu)
v2023.1, v2023.2, etc.): FR, (thanks @Kaspiman)🐛 gRPC plugin: allow specifying wildcards in the proto field: PR, (thanks @MaxSem)
proto field: PR, (thanks @MaxSem)multiple_ack): BUG, (thanks @embargo2710)🐛 AMQP plugin: Driver crash when not using OTEL metrics: BUG, (thanks @rauanmayemir)
🐛 SQS plugin: Revert optimized check for the AWS environment, BUG, (thanks @sergey-telpuk)
🐛 Centrifuge plugin: Fix incorrect proto package import that caused panic on large payload PR
TestCommandWorkingDir predifined temp directory, BUG, (thanks @shyim)superfluous response.WriteHeader bug, BUG, (thanks @mfadul24)✒️ Kafka plugin: Completely rewritten Kafka plugin. Now supports regexps for topics, marked commits for group consumers, and SASL authentication. Conf
reload plugin has been removed from the default plugins list. Please use *.pool.debug=true instead.curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/roadrunner-server/roadrunner/master/download-latest.sh | sh
require section: PR, (thanks @roxblnfk)consumer_id can now be set in configuration, FR, (thanks @codercms)v2023.1.0 RR did not accept the empty queue name, CHtemporal, http, gRPC and Jobs plugins, including all Jobs drivers.version: '3'. ️SIGKILL, send SIGINT with a 5s timeout to stop the underlying processes.${LOG-LEVEL:-debug}. That is, if the LOG-LEVEL env variable is not set, use debug.2023.2.0.2023.2.0.grpc.Workers immediately after RR start.BUG, (thanks @genhoi)✒️ Velox: Support for v2023 and v4 plugins. v2 and v3 plugins are still supported, release
v2023 and v4 plugins. v2 and v3 plugins are still supported, releaseremain_after_exit.SIGINT instead of SIGKILL to underlying processes with 5s timeout to let the process exit gracefully.✒️ Server plugin: pass the RR_VERSION env variable to the worker to check the current RR version; version passed without the v prefix (e.g. 2023.1.0).
RR_VERSION env variable to the worker to check the current RR version; version passed without the v prefix (e.g. 2023.1.0).✒️ Kafka plugin: Totally reworked Kafka plugin. Now it supports regexps for the topics, marked commits for the group consumers, and SASL authenticatio
curl --proto '=https' --tlsv1.2 -sSf https://raw.githubusercontent.com/roadrunner-server/roadrunner/master/download-latest.sh | sh
require section: PR, (thanks @roxblnfk)consumer_id can now be set from the configuration, FR, (thanks @codercms)v2023.1.0 RR would not accept the empty queue name, CHtemporal, http, gRPC and Jobs plugins including all Jobs drivers.version: '3'. ️One column per quarter.