RabbitMQ Installation on Windows

Here we will learn how to setup or install Erlang and RabbitMQ on windows machines and how to enable RabbitMQ web management plugin in step by step manner.

 

The RabbitMQ is built on Erlang runtime environment so before we install RabbitMQ, first we need to download and install Erlang in our machines.

What is Erlang?

Erlang is a general-purpose programming language and runtime environment.

 

Erlang has built-in support for concurrency, distribution and fault tolerance. Erlang is used in several large telecommunication systems from Ericsson.

Erlang Installation

Following is the link to download and install Erlang on your windows machine.

 

http://www.erlang.org/downloads

 

Once you open above URL, select a required version to download and install on your machines like as shown following.

 

Download Required Erlang Version to Install on Windows

 

After downloading the required Erlang version, now we will install Erlang for that double click on downloaded install file and follow the instructions like as shown below.

 

Erlang OTP Setup on Windows

RabbitMQ Installation

After completion of Erlang installation, now we will install RabbitMQ on windows for that download a RabbitMQ setup file from following link for windows.

 

https://www.rabbitmq.com/download.html

 

After opening the above URL, we will get a RabbitMQ setup files information like as shown below. Here we are going to install a RabbitMQ server on windows machine so we will download the windows version like as shown below.

 

Downloading and Installing RabbitMQ on Windows

 

After downloading the required setup file, just double click on setup file to install rabbitmq on windows like as shown below.

 

RabbitMQ Server Installation Setup

Starting RabbitMQ Server

After completion of installing the RabbitMQ server, we will check the status of RabbitMQ server for that search for RabbitMQ Command Prompt and open it with admin privilege like as shown below.

 

Open a RabbitMQ Command Prompt with Admin Permissions

 

After opening the command prompt, enter command “rabbitmqctl status” and click enter to check the status of RabbitMQ server.

 

In case, if it shows an error like as below, then you need to follow the given steps to fix this error.

 

RabbitMQ Server Starting Error

RabbitMQ Authentication Failed Error

Following are the steps to fix an error like “Authentication failed (rejected by the remote node), check the Erlang cookie”.

 

  1. In file explorer navigate to your user directory by pasting %userprofile% in your address bar.
  2. In case if already .erlang.cookie file available in that location, just delete it otherwise go to the next step.
  3. In a second File Explorer, navigate to C:\Windows\System32\config\systemprofile.
  4. Find the file .erlang.cookie and copy it to your user directory.
  5. Now your rabbitmqctl should be able to authenticate.

After completion of above steps, then again run “rabbitmqctl status” command in rabbitmq command prompt as an administrator, then it will shows the screen like as shown below.

 

Successfully Starting RabbitMQ Server

 

Now, we are done with starting the RabbitMQ server, next we will enable a web management plugin for RabbitMQ.

RabbitMQ Enable Web Management Plugin

To enable a rabbitmq web management plugin on windows, we need to start RabbitMQ Command Prompt with administrator privilege, enter the command “rabbitmq-plugins enable rabbitmq_management” and execute it.

 

After executing the above web management command, the web management plugins will be enabled and it will show the plugins list which are enabled.

 

After Starting RabbitMQ Web Management Plugin

 

Now you can open web management plugin in the browser for that enter the following URL in browser and click enter.

 

http://localhost:15672

 

After opening the localhost URL in browser, it will ask you for credentials to access web management plugin.

 

To access rabbitmq web management dashboard, the default Username and password of  is “guest” (Username: “guest” | Password: “guest”).

 

RabbitMQ Server Web Management Login Screen

 

After login with default credentials, the following overview screen will appear.

 

RabbitMQ Server Dashboard

 

Now we have successfully started the RabbitMQ server and web management plugin.

 

In next chapters, we will learn about the available components of RabbitMQ such as Exchanges, Queues, Channels, etc with examples.