RabbitMQ queue management tools

rabbitmq-queues [-q] [-s] [-l] [-n node] [-t timeout] command [command_options]

rabbitmq-queues is a command line tool that provides commands used to manage queues, mainly member handling for quorum queues. See the RabbitMQ quorum queues guide and RabbitMQ classic mirrored queues guide to learn more about queue types in RabbitMQ.

Default node is "rabbit@target-hostname", where target-hostname is the local host. On a host named "", the node name will usually be "rabbit@myserver" (unless RABBITMQ_NODENAME has been overridden). The output of "hostname -s" is usually the correct suffix to use after the "@" sign. See rabbitmq-server(8) for details of configuring a RabbitMQ node.
, --quiet
Quiet output mode is selected. Informational messages are reduced when quiet mode is in effect.
, --silent
Silent output mode is selected. Informational messages are reduced and table headers are suppressed when silent mode is in effect.
timeout, --timeout timeout
Operation timeout in seconds. Not all commands support timeouts. Default is infinity.
, --longnames
Must be specified when the cluster is configured to use long (FQDN) node names. To learn more, see the RabbitMQ Clustering guide
Shared secret to use to authenticate to the target node. Prefer using a local file or the RABBITMQ_ERLANG_COOKIE environment variable instead of specifying this option on the command line. To learn more, see the RabbitMQ CLI Tools guide

Displays general help and commands supported by rabbitmq-queues.

node selector --vhost-pattern pattern --queue-pattern pattern --errors-only

Adds a new replica on the given node for all or a half of matching quorum queues.

Supported selector values are:

Selects all quorum queues
Selects quorum queues with an even number of replicas


rabbitmq-queues grow "rabbit@newhost" "all" --vhost-pattern "a-vhost" --queue-pattern ".*"
type --vhost-pattern pattern --queue-pattern pattern

Rebalances queue master replicas across cluster nodes.

Supported type values are:

All queue types
Only quorum queues
Only classic queues


rabbitmq-queues rebalance "all" --vhost-pattern "a-vhost" --queue-pattern ".*"

Shrinks quorum queue clusters by removing any members (replicas) on the given node.


rabbitmq-queues shrink "rabbit@decomissioned-node"

queue node --vhost virtual-host

Adds a quorum queue member (replica) on the given node.


rabbitmq-queues add_member --vhost "a-vhost" "a-queue" "rabbit@new-node"
queue node --vhost virtual-host

Removes a quorum queue member (replica) on the given node.


rabbitmq-queues delete_member --vhost "a-vhost" "a-queue" "rabbit@decomissioned-node"

queue --vhost virtual-host

Displays quorum status of a quorum queue.


rabbitmq-queues quorum_status --vhost "a-vhost" "a-queue"

rabbitmqctl(8), rabbitmq-diagnostics(8), rabbitmq-server(8), rabbitmq-upgrade(8), rabbitmq-service(8), rabbitmq-env.conf(5), rabbitmq-echopid(8)

The RabbitMQ Team <>

Getting Help and Providing Feedback

If you have questions about the contents of this guide or any other topic related to RabbitMQ, don't hesitate to ask them on the RabbitMQ mailing list.

Help Us Improve the Docs <3

If you'd like to contribute an improvement to the site, its source is available on GitHub. Simply fork the repository and submit a pull request. Thank you!