---
updatedAt: 2026-07-24T06:09:20.000Z
agentTools:
  siteIndex: https://docs.jfrog.com/llms.txt
  projectIndex: https://docs.jfrog.com/installation/llms.txt
---

# Quorum Queue Enablement for Xray and Platform Helm Charts

Enable RabbitMQ Quorum Queues in Xray 3.124.x+ and Platform Helm charts. Replaces deprecated Classic Queue mirroring.

For prerequisites and an overview of the full quorum upgrade process, see the [Quorum Queue Upgrade landing page](xray-rabbitmq-quorum-upgrade#prerequisites).

Support for quorum queues has been added in JFrog Xray chart version 3.124.x. Currently, Xray uses RabbitMQ with mirrored classic queues. We recommend transitioning to quorum queues, as classic queue mirroring will be deprecated in RabbitMQ 4.x.

<Callout icon="⚠️" theme="warning">
  **Applies to Both Xray and Platform Charts**

  * **Irreversible Migration**: Once you switch to quorum queues, rolling back to classic queues is not supported. Switch only when you are ready to commit permanently.
  * **Replica Count**: In quorum mode, a RabbitMQ `replicaCount` of 3 is recommended for high availability.
</Callout>

## Xray Charts

<Callout icon="📘" theme="info">
  **Note**

  From version 3.124.x
</Callout>

### Fresh Installation

Apply the following configuration to enable quorum queues during a fresh install.

```yaml
rabbitmq:
  replicaCount: 3
  podManagementPolicy: Parallel

global:
  xray:
    rabbitmq:
      replicaCount: 3
      haQuorum:
        enabled: true
      migrateMessagesFromXrayDefaultVhost: true
```

### Upgrade from Classic to Quorum Queues

Apply the following configuration to upgrade from classic queues to quorum queues:

```yaml
rabbitmq:
  replicaCount: 3
  podManagementPolicy: Parallel
  extraPlugins: "rabbitmq_shovel rabbitmq_shovel_management"
  migration:
    deleteStatefulSetToAllowFieldUpdate:
      enabled: true
    removeHaPolicyOnMigrationToHaQuorum:
      enabled: true

global:
  xray:
    rabbitmq:
      replicaCount: 3
      haQuorum:
        enabled: true
      migrateMessagesFromXrayDefaultVhost: true
```

## Platform Charts

<Callout icon="📘" theme="info">
  **Note**

  From version 11.2.0
</Callout>

### Fresh Installation

Apply the following configuration to enable quorum queues during a fresh install:

```yaml
rabbitmq:
  replicaCount: 3
  podManagementPolicy: Parallel

global:
  xray:
    rabbitmq:
      replicaCount: 3
      haQuorum:
        enabled: true
      migrateMessagesFromXrayDefaultVhost: true
```

### Upgrade from Classic to Quorum Queues

Apply the following configuration to upgrade from classic queues to quorum queues:

```yaml
rabbitmq:
  replicaCount: 3
  podManagementPolicy: Parallel
  extraPlugins: "rabbitmq_shovel rabbitmq_shovel_management"
  migration:
    deleteStatefulSetToAllowFieldUpdate:
      enabled: true
    removeHaPolicyOnMigrationToHaQuorum:
      enabled: true

global:
  xray:
    rabbitmq:
      replicaCount: 3
      haQuorum:
        enabled: true
      migrateMessagesFromXrayDefaultVhost: true
```

## Verify the migration is successful

Verify the migration is successful. See [Verify quorum migration is complete](xray-installupgrade-troubleshooting#6-verify-quorum-migration-is-complete).

## Switch to RabbitMQ 4.x

<Callout icon="📘" theme="info">
  **Note**

  Switching to RabbitMQ 4.x requires quorum queues to be enabled in the existing deployment. First, switch to quorum queues and verify the migration is successful, and then upgrade to RabbitMQ 4 in a two-stage process.
</Callout>

### Xray Charts

Override the below values in values.yaml. The repository must also be overridden since the new image tag comes from the Echo repositories.

```yaml
rabbitmq:
  image:
    repository: echohq/rabbitmq
    tag: 4.1-helm-20260716
```

### Platform Charts

Override the below values in values.yaml. The repository must also be overridden since the new image tag comes from the Echo repositories.

```yaml
rabbitmq:
  image:
    repository: echohq/rabbitmq
    tag: 4.1-helm-20260716
```

## Related Topics

* [Xray Installation](installing-xray)
* [Xray HA Helm Installation](xray-ha-helm-installation)
* [RabbitMQ (Split) for Xray](rabbitmq-split-for-xray)
* [Xray System Requirements and Platform Support](xray-system-requirements-and-platform-support)
* [Upgrading Xray](upgrading-xray)