Beanstalk is a simple and fast general purpose work queue. To install Beanstalk, you can use the local queue server or run the server inside AWS Elastic. You can choose any option that is convenient for you.

Setting up the server is similar to setting up AMQP and requires specifying the connection in the beanstalk section of your RoadRunner configuration file.

  addr: tcp://


version: "3"

  # Optional section.
  # Default: tcp://
  addr: tcp://

  # Optional section.
  # Default: 30s
  timeout: 10s

    # User defined name of the queue.
      # Required section.
      # Should be "beanstalk" for the Beanstalk driver.
      driver: beanstalk

      config: # NEW in 2.7

        # Optional section.
        # Default: 10
        priority: 10

        # Consume any payload type (not only Jobs structured)
        # Default: false
        consume_all: false

        # Optional section.
        # Default: 1
        tube_priority: 1

        # Optional section.
        # Default: default
        tube: default

        # Optional section.
        # Default: 5s
        reserve_timeout: 5s

Configuration options

Here is a detailed description of each of the beanstalk-specific options:


priority - Similar to the same option in other drivers. This is queue default priority for each task pushed into this queue if the priority value for these tasks was not explicitly set. Lower value - higher priority.

Tube priority

tube_priority - The value for specifying the priority within Beanstalk is the internal priority of the server. The value should not exceed int32 size.


tube - The name of the inner "tube" specific to the Beanstalk driver.

Consume all

consume_all - By default, RR supports only Jobs structures from the queue. Set this option to true if you want to also consume the raw payloads.

Last updated