• Installation
• Documentation
• Tutorials
• Services
• Community
• Blog

Installing on RPM-based Linux (CentOS, Fedora, OpenSuse, RedHat)

Download the Server

rabbitmq-server is included in Fedora. However, the versions included are often quite old. You will probably get better results installing the .rpm from our website. Check the Fedora package details for which version of the server is available for which versions of the distribution.

Before installing RabbitMQ, you must install Erlang. We strongly recommend using a packaged version. There are three suggested sources for Erlang packages:

• EPEL ("Extra Packages for Enterprise Linux"); part of the Red Hat / Fedora organisation, provides many additional packages, including Erlang. These are the most official packages, and are split into many small packages, but are not always up to date.
• Erlang Solutions produces packages that are usually up to date. They are not split up, and include all of Erlang - which can mean they require large numbers of dependencies.
• VMware produces a package stripped down to only provide those components needed to run RabbitMQ. It may not be as up to date as Erlang Solutions' packages.

Install Erlang from EPEL or

Note: the steps you need to take vary, depending on which version of RHEL you are on.

1. Enable EPEL (all versions)
   

   Follow the steps in the EPEL FAQ to enable EPEL on your machine.

2. Enable Erlang repository (RHEL 5 and derived, including Fedora 6 and CentOS 5)
   

   If you are on a later version of RHEL (or derived) you should skip this step.

   Due to the EPEL package update policy, EPEL 5 contains a relatively old version of Erlang, R12B-5. Although rabbitmq-server supports R12B-5, performance may be lower than for more recent Erlang versions and certain non-core features are unsupported, such as SSL and HTTP-based plugins including the management plugin.

   To install a more recent version of Erlang you need to enable a more up-to-date package repository that is provided by the owner of the Erlang package. To do this, issue the following command as 'root':

   wget -O /etc/yum.repos.d/epel-erlang.repo http://repos.fedorapeople.org/repos/peter/erlang/epel-erlang.repo

3. Install (or update) Erlang (all versions)
   

   Issue the following command as 'root':

   yum install erlang

Install Erlang from Erlang Solutions or

1. Download and install the appropriate RPM from Erlang Solutions.
2. Download and install the esl-erlang-compat RPM (direct download) produced by Jason McIntosh.

   This is needed since Erlang Solutions' packages provide "esl-erlang"; this package just requires "esl-erlang" and provides "erlang".

Install Erlang from VMware

1. Download and install the appropriate RPM from VMware.

Install the Server

After downloading the server package, issue the following command as 'root':

rpm --import http://www.rabbitmq.com/rabbitmq-signing-key-public.asc
      yum install rabbitmq-server-3.1.1-1.noarch.rpm

Run RabbitMQ Server

Customise RabbitMQ Environment Variables

The server should start using defaults. You can customise the RabbitMQ environment. Also see how to configure components.

Start the Server

The server is not started as a daemon by default when the RabbitMQ server package is installed. To start the daemon by default when the system boots, as an administrator run chkconfig rabbitmq-server on.

As an administrator, start and stop the server as usual using /sbin/service rabbitmq-server stop/start/etc.

Note: The server is set up to run as system user rabbitmq. If you change the location of the Mnesia database or the logs, you must ensure the files are owned by this user (and also update the environment variables).