RabbitMQ - Configuration

Introduction

RabbitMQ comes with default built-in settings which will most likely be sufficient for running your RabbitMQ server effectively. If it runs fine, then you probably don't need any configuration at all. If you have other constraints, RabbitMQ provides two general ways to customise the server:

environment variables define ports, file locations, names;
a configuration file defines component settings for permissions, limits and clusters, and also for plugins.

RabbitMQ environment settings are prefixed with RABBITMQ_ and environment settings take priority over start script built-in default values. Local shell environment settings will take priority over the more general settings described below. Similarly, values set in the configuration file take priority over built-in defaults.

Verify Configuration

The active configuration can be verified in the startup banner, e.g. the active configuration file:

config file(s) : /etc/rabbitmq/rabbitmq.config

This may appear in on the console or in a file, depending on how the broker was started:

Linux (when running as a service): see the startup_log file in the log directory;
MacOSX (macports): see ${install prefix}/var/log/rabbitmq/startupitem.log;
Started as rabbitmq-server (without the -detached option): see console output;
Windows Service: enable RABBITMQ_CONSOLE_LOG and check the .debug file.

The startup banner is not available if the broker is started in detached mode.

Customise RabbitMQ Environment

Unix (general)

On Unix-based systems (including Linux, MacOSX) you can create/edit rabbitmq-env.conf to define environment variables. Its location is not configurable (unlike rabbitmq.config, which is by default in the same directory).

Use the standard environment variable names (but drop the RABBITMQ_ prefix) e.g.

#example rabbitmq-env.conf file entries
#Rename the node
NODENAME=bunny
#Config file location and new filename bunnies.config
CONFIG_FILE=/etc/rabbitmq/testdir/bunnies

More info on using rabbitmq-env.conf

Windows

If you need to customise names, ports, locations, it is easiest to configure environment variables in the Windows dialogue: Start > Settings > Control Panel > System > Advanced > Environment Variables.

Create or edit the system variable name and value. For environment changes to take effect, open a new Command Prompt, then restart the broker or re-install the service.

RabbitMQ Environment Variables

It is unlikely you will need to set any of these environment variables. If you have non standard requirements, then RabbitMQ environment variables include:

Name	Default	Description
RABBITMQ_NODE_IP_ADDRESS		Defaults to the empty string - meaning bind to all network interfaces. This can be changed if you only want to bind to one network interface.
RABBITMQ_NODE_PORT	5672
HOSTNAME	Unix, Linux: `env hostname` MacOSX: `env hostname -s`	The name of the current machine
COMPUTERNAME	Windows: localhost	The name of the current machine
RABBITMQ_BASE	Windows: %APPDATA%\RabbitMQ	This base directory contains sub-directories for the RabbitMQ server's database and log files. Alternatively, set RABBITMQ_MNESIA_BASE and RABBITMQ_LOG_BASE individually.
RABBITMQ_NODENAME	*Unix: rabbit@$HOSTNAME Windows:** rabbit@%COMPUTERNAME%	The node name should be unique per erlang-node-and-machine combination. To run multiple nodes, see the clustering guide.
RABBITMQ_CONFIG_FILE	*Unix: /etc/rabbitmq/rabbitmq Windows:** %RABBITMQ_BASE%\rabbitmq	If the configuration file is present it is used by the server to configure RabbitMQ components. The .config extension is automatically appended by the Erlang runtime. This file is also used to auto-configure RabbitMQ clusters.
RABBITMQ_MNESIA_BASE	*Unix: /var/lib/rabbitmq/mnesia Windows:** %RABBITMQ_BASE%\db	The directory where Mnesia database files should be placed.
RABBITMQ_LOG_BASE	*Unix: /var/log/rabbitmq Windows:** %RABBITMQ_BASE%\log	Log files generated by the server will be placed in this directory.
ERLANG_SERVICE_MANAGER_PATH	Windows Service: %ERLANG_HOME%\erts-5.7.4\bin	This path is the location of erlsrv.exe, the Erlang service wrapper script.
RABBITMQ_SERVICENAME	Windows Service: RabbitMQ	The name of the installed service. This will appear in services.msc.
RABBITMQ_CONSOLE_LOG	Windows Service:	Set this variable to new or reuse to redirect console output from the server to a file named %RABBITMQ_SERVICENAME%.debug in the default RABBITMQ_BASE directory. If not set, console output from the server will be discarded (default). new A new file will be created each time the service starts. reuse The file will be overwritten each time the service starts.

* Unix, Linux, MacOSX

Paths are given relative to the installation directory prefix. For example Mac OSX (macports) are normally based in /opt/local/, or /usr/local on Mac OSX (homebrew) and some BSD installations.

Configuration File

The rabbitmq.config File

The configuration file rabbitmq.config allows the RabbitMQ core application, Erlang services and RabbitMQ plugins to be configured. It is a standard Erlang configuration file, documented on the Erlang Config Man Page.

An example configuration file follows:

  [
    {mnesia, [{dump_log_write_threshold, 1000}]},
    {rabbit, []}
  ].

This example will alter the dump_log_write_threshold for mnesia (increasing from the default of 100).

This configuration file is not the same as rabbitmq-env.conf, which can be used to set environment variables on non-windows systems. A future release of RabbitMQ will unify the two configuration mechanisms.

Location of rabbitmq.config and rabbitmq-env.conf

The location of these files is distribution-specific. By default, they are not created, but expect to be located in the following places on each platform:

Generic UNIX - /etc/rabbitmq/
Debian - /etc/rabbitmq/
RPM - /etc/rabbitmq/
Mac OS X (Macports) - /opt/local/etc/rabbitmq/
Windows - %APPDATA%\RabbitMQ\

If rabbitmq-env.conf doesn't exist, it can be created manually in the default location only. It is not used on Windows systems.

If rabbitmq.config doesn't exist, it can be created manually. Set the RABBITMQ_CONFIG_FILE environment variable if you change the location. The Erlang runtime automatically appends the .config extension to the value of this variable.

Restart the server after changes. If running as a Windows Service, remove, install and restart the RabbitMQ service.

RabbitMQ Server Configuration