--- title: "RabbitMQ Module" slug: "rabbitmq" description: "This document shows users how to connect flows built in Decisions, via the Rabbit Message Queue (RabbitMQ). RabbitMQ is a messaging system for application-to-application communication, that queues subscribers so that flows can work messages. " tags: ["rabbitmq", "messaging", "message queue"] updated: 2026-03-30T18:39:11Z published: 2026-03-30T18:39:11Z --- > ## Documentation Index > Fetch the complete documentation index at: https://documentation.decisions.com/llms.txt > Use this file to discover all available pages before exploring further. # RabbitMQ Module ## Overview **Rabbit Message Queue (RabbitMQ**) is a messaging system for application-to-application communication. The RabbitMQ Module adds the capability to the **Decisions Messaging Service**, which lets users connect to built-in Flow steps to manage a RabbitMQ. The RabbitMQ Module allows users to queue subscribers so that Flow can work and push messages to Queues using Flow steps. Users can also integrate with RabbitMQ, take in a message, and then convert the message to any type of data for processing. To configure RabbitMQ in Decisions, users must install the RabbitMQ Module. Refer to our [Installing Modules](https://documentation.decisions.com/v9/docs/installing-modules-decisions) article. ## Prerequisites - [Install](/v9/docs/installing-modules-decisions)the **Rabbit****MQ Module.** - Create a [project dependency](https://documentation.decisions.com/v9/docs/project-dependencies) ## Considerations Note for Third-Party Systems and SubscriptionsCustomers are responsible for securing and maintaining accounts with third-party systems and subscriptions. --- ## Installing RabbitMQ Refer to RabbitMQ's official website to [Download and Install RabbitMQ](https://www.rabbitmq.com/download.html). --- ## RabbitMQ Settings 1. To establish a connection with a RabbitMQ broker, users must configure the server information in **System Settings**. This can be found by navigating to **System > Settings > Message Queue Settings > RabbitMQ Settings.** ![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/RabbitMQ%20Client%20Cert%20Authentication.png) 2. Below is a breakdown of each property for the setting. These configurations will serve as global settings for all the **RabbitMQ Message Queues** that will be created in the next section. | Property | Setting | | --- | --- | | Default Server IP or Name | The Default Server IP or name hosting the RabbitMQ broker. | | Use Default Port | When disabled, it opens a new field where the port number can be specified. Ensure the port is open and is not assigned to any other service. | | Default Virtual Host | An optional field used to identify the virtual host location. Due to RabbitMQ being a multi-tenant system, it allows for a specific tenant to be used as the connected system. | | Default User Name | Sets the default user name when establishing a connection to RabbitMQ. | | Default Password | Sets the default password for establishing a connection to RabbitMQ. | | Use SSL | When enabled, this will open a field to enter the Server certificate name. | | Server certificate CN name | Enter the name of the server certificate CN (Common Name / Fully Qualified Domain Name). | | Verify server CN name | When enabled, this will verify the certificate (Common Name / Fully Qualified Domain Name). | | Verify server certificate chain | When enabled, this will verify the certificate chain. | | Use Client Certificate | Enables client certificate authentication. When enabled, additional fields for certificate path and password are displayed. | | Client Certificate Path | Specifies the file path to the client certificate used for authentication when SSL is enabled. | | Client Certificate Password | Specifies the password associated with the client certificate. | --- ## Connecting to a RabbitMQ 1. Navigate to **Systems > Jobs and Events >****Message Queues**and select******Add Rabbit Queue**. 2. On the **Add Rabbit Queue** dialog window, enter a **Display Name** and the **Queue Name**. Configure any other options necessary and click **SAVE**. | **DEFINITION** | | --- | | | Display Name | Determines how the Queue's name displays. | | | Queue Name | The name of the Queue that the system references. | | | Is Durable Queue | When Decisions create the Queue, this setting keeps the Message permanent. If no one is using the Queue, this setting will reclaim the Message Queue and recreate the Message. | | | Auto Delete | Instructs the Message Server to delete the Queue when its last consumer disconnects. | | | Use Passive Queue Declaration | This setting only verifies that the queue exists on the RabbitMQ server without the ability to create it. No other permissions are needed. | | | Override Server Info | This will override the server settings configured in the [RabbitMQ Settings](/v9/docs/rabbitmq-message-services#global-rabbitmq-settings). | | | | Server IP or Name | The Server IP or name hosting the RabbitMQ. | | | | Use Default Port | When disabled, this will open a new field where the port number can be specified. Ensure the port is open and is not assigned to any other service. | | | Virtual Host Override Behavior | | | | | Override if Specified (Otherwise use default) | This will override the virtual host configured in the [RabbitMQ Setting](/v9/docs/rabbitmq-message-services#global-rabbitmq-settings) only if specified. | | | | Never Override (Always use default) | Will not allow override virtual host. | | | | Always Override | Will always override the virtual host configured in the [RabbitMQ Setting](/v9/docs/rabbitmq-message-services#global-rabbitmq-settings). | | | Override Virtual Host | This will override the Virtual Host configured in the [RabbitMQ Settings](/v9/docs/rabbitmq-message-services#global-rabbitmq-settings). Allows the ability to set up multiple virtual hosts allowing the user to host Decisions. The Virtual host runs to keep the actual production from interference. | | | Override Queue Credentials | This will override the credentials configured in the [RabbitMQ Settings](/v9/docs/rabbitmq-message-services#global-rabbitmq-settings). Provides the ability to set up a username and password that can be assigned, allowing specific credentials to be required | | | Override SSL | This will override the SSL configured in the [RabbitMQ Settings](/v9/docs/rabbitmq-message-services#global-rabbitmq-settings). Enables the use of SSL for specific Message queues. | | | | Server certificate CN name | Enter the name of the server certificate CN (Common Name / Fully Qualified Domain Name). | | | | Verify server CN name | When enabled, this will verify the CN (Common Name) of the entered certificate. | | | | Verify server certificate chain | When enabled, this will verify the certificate chain of the entered certificate. | | **QUEUE ARGUMENTS** | | | Queue Type | Specifies the queue type (classic, quorum) | | | Dead Letter Exchange | The queue for undelivered or failed messages | | | Dead Letter Routing Key | Routing key for dead letter | | | Maximum Queue Length | Sets the maximum queue length | | | Message TTL (msec) | Sets the message time-to-live in milliseconds. | These values can be found within the web portal for **RabbitMQ** under the **Queues** section. These values must match; otherwise, a new queue will be created within RabbitMQ to match the settings defined in Decisions.![](https://cdn.document360.io/6ef8bcc1-6489-4486-9ad1-83acff7e5df0/Images/Documentation/image-1665605824898.png) 3. Navigate to **System > Jobs and Events > Message Queues**. Right-click on the **Message Queue** and select **Control**. Select **Test Queue**to verify the connection with RabbitMQ. If successful, a dialog pop-up screen will appear, displaying the test result. | Configuration Options | Description | | --- | --- | | Disable Queue | Disables the queue | | Resync Queue | Recreates the Message Queues if necessary and resynchronizes with the Message Server | | Start Queue | Starts processing Messages on the Message Queues (if stopped) | | Stop Queue | Stops processing Messages on the Message Queues. The Message Server will hold any unprocessed messages. | | Test Queue | Reads the number of awaiting Messages in the Queue and shows a pop-up with the number of awaiting Messages | Related Articles: 1. To subscribe to messages in a queue, a Message Handler Flow needs to be configured. For more information, refer to [Setting Up Message Handlers](https://documentation.decisions.com/v9/docs/setting-up-messaging-overview). 2. Refer to the Step Article Library to learn more about how to use RabbitMQ Flow steps within a Flow. [](https://documentation.decisions.com/step-library/docs/disable-rabbit-queue#) - [Disable Rabbit Queue](https://documentation.decisions.com/step-library/docs/disable-rabbit-queue#) [](https://documentation.decisions.com/step-library/docs/enable-rabbit-queue) - [Enable Rabbit Queue](https://documentation.decisions.com/step-library/docs/enable-rabbit-queue) [](https://documentation.decisions.com/step-library/docs/get-string-from-rabbit-queue) - [Get String from Rabbit Queue](https://documentation.decisions.com/step-library/docs/get-string-from-rabbit-queue) [](https://documentation.decisions.com/step-library/docs/put-message-in-rabbit-queue) - [Put Message in Rabbit Queue](https://documentation.decisions.com/step-library/docs/put-message-in-rabbit-queue) - [Put String In Rabbit Exchange](https://documentation.decisions.com/step-library/docs/put-string-in-rabbit-exchange) [](https://documentation.decisions.com/step-library/docs/put-string-in-rabbit-queue) - [Put String in Rabbit Queue](https://documentation.decisions.com/step-library/docs/put-string-in-rabbit-queue) [](https://documentation.decisions.com/step-library/docs/resync-rabbit-queue) - [Resync Rabbit Queue](https://documentation.decisions.com/step-library/docs/resync-rabbit-queue) - [Test Rabbit Queue](https://documentation.decisions.com/step-library/docs/test-rabbit-queue) --- ## Feature Changes | Description | Version | Release Date | Developer Task | | --- | --- | --- | --- | | Authentication Via Certificate | [9.22](https://documentation.decisions.com/v99/docs/version-922x-release-notes?highlight=DT-046677) | March 2026 | [DT-046677] | | Added Use Passive Queue Declaration action. | [9.13](https://documentation.decisions.com/v99/docs/version-913x-release-notes) | July 2025 | [DT-044636] | | A hidden Module called Decisions.MessageQueues Module will be downloaded automatically when any message queue Module is installed. | 9.0 | May 2024 | [DT-039289] | | Added new setting on RabbitMQ Queues: Virtual Host Override Behavior. | [8.13](https://documentation.decisions.com/v99/docs/version-8x) | September 2024 | [DT-038175] | --- For further information on Modules, visit the [Decisions Forum](https://community.decisions.com/categories/Modules).