ℹ️
This page covers upgrading an existing Xray instance to RabbitMQ quorum queues. It does not apply to fresh installations — see the fresh installation documentation for new deployments.

Prerequisites

Before you upgrade to quorum mode:

An existing Xray non quorum deployment in any of the following modes:
- Single-node Xray with bundled RabbitMQ
- Multi-node Xray with bundled RabbitMQ in each node
- Single-node Xray and Single-node RabbitMQ deployed independently on separate nodes (split mode)
- Multi-node Xray and Multi-node RabbitMQ deployed independently on separate nodes (split mode)
Use Xray version 3.124.x or later — earlier versions don't support upgrading the bundled RabbitMQ to quorum mode. It is recommended to use the latest available version.

Upgrade Process

Follow the section that matches how your existing Xray instance was installed according to the installer type.

1. Helm

For Helm-based deployments, follow the Quorum Queue Enablement for Xray and Platform Helm Charts guide. It covers both chart types:

Xray standalone charts
Platform charts

2. Linux Archive/ RPM, DEB / Docker Compose

installv2.sh/configV2.sh (recommended installer script for version 3.131.x and later)

Use this script if you run installations manually, or if you previously used install.sh/config.sh and want to move to the supported path. If you're already on installV2.sh/configV2.sh, continue using it for future upgrades.

Follow the guide for your deployment type:

❗️
Note: If your existing Xray instance is automated with the original install.sh script, follow the non-breaking upgrade instructions in Migrating to Quorum Queue / Quorum Queue Enablement for Xray in Native Installer
The legacy (script install.sh/config.sh) is retained only to avoid breaking existing automated deployments. For all new manual installs, use installV2.sh/configV2.sh.