Edit content

Environment configuration

All RoadRunner workers will inherit the system configuration available for the parent server process. In addition, you can customize the set of env variables to be passed to your workers using part env of .rr configuration file.

  command: "php worker.php"
     key: value

All keys will be automatically uppercased!

Using environment variables in the configuration

set -a
source /var/www/config/.env
set +a

exec /var/www/rr \
  -c /var/www/.rr.yaml \
  -w /var/www \  
  -o http.pool.num_workers=${RR_NUM_WORKERS:-8} \
  -o http.pool.max_jobs=${RR_MAX_JOBS:-16} \
  -o http.pool.supervisor.max_worker_memory=${RR_MAX_WORKER_MEMORY:-512}


  • -w: is working directory.
  • -o: is option to overwrite. All options might be overwritten.
  • /var/www/config/.env: contains needed env variables.
  • ${RR_NUM_WORKERS:-8}: Use RR_NUM_WORKERS or 8 by default (if no there are no RR_NUM_WORKERS in the .env)

Default ENV values inside the worker

RoadRunner provides set of ENV values to help the PHP process to identify how to properly communicate with the server.

Key Description
RR_MODE Identifies what mode worker should work with (http, temporal, grpc, jobs, tcp)
RR_RPC Contains RPC connection address when enabled.
RR_RELAY "pipes" or "tcp://...", depends on server relay configuration.