RabbitMQ Install on Windows

Installing RabbitMQ on Windows takes about ten minutes. RabbitMQ runs on top of Erlang, so you install Erlang first and then RabbitMQ. This guide walks through each step clearly.

What You Need Before You Start

A Windows PC running Windows 10 or Windows 11 (64-bit)
Administrator access to your machine
An internet connection

Step 1 – Install Erlang

RabbitMQ is written in Erlang, so Erlang must be installed first. Go to the official Erlang download page at erlang.org/downloads and download the latest Windows installer (OTP 26 or higher is recommended for recent RabbitMQ versions).

Run the installer with administrator privileges. Accept the default installation path (C:\Program Files\Erlang OTP). The installer adds Erlang to your system automatically.

After installation, open Command Prompt and type:

erl -version

You should see the Erlang version printed. If you see an error, Erlang is not in your system PATH — you may need to add it manually in Environment Variables.

Step 2 – Download the RabbitMQ Installer

Go to rabbitmq.com/install-windows.html and download the latest RabbitMQ Windows installer (a .exe file). The file name looks like rabbitmq-server-3.x.x.exe.

Step 3 – Run the RabbitMQ Installer

Double-click the downloaded installer. Accept the license agreement and keep the default installation directory (C:\Program Files\RabbitMQ Server). Click Install and wait for it to finish.

The installer registers RabbitMQ as a Windows Service automatically. This means RabbitMQ starts every time Windows boots.

Step 4 – Enable the Management Plugin

RabbitMQ comes with a powerful web UI, but you must enable it first. Open the RabbitMQ Command Prompt (search "RabbitMQ Command Prompt" in the Start menu) and run:

rabbitmq-plugins enable rabbitmq_management

You will see output confirming the plugin is enabled. Restart RabbitMQ to apply the change:

rabbitmq-service.bat restart

Step 5 – Open the Management UI

Open your browser and go to:

http://localhost:15672

Username: guest
Password: guest

The RabbitMQ Management Dashboard appears. You can see queues, exchanges, connections, and much more from this dashboard.

Step 6 – Verify RabbitMQ is Running

In the RabbitMQ Command Prompt, run:

rabbitmqctl status

This command prints a detailed status report. Look for the line that says RabbitMQ is running. If the service is not running, start it with:

rabbitmq-service.bat start

Common Issues on Windows

Erlang Not Found

If RabbitMQ cannot find Erlang, you need to set the ERLANG_HOME environment variable manually. Go to Control Panel → System → Advanced System Settings → Environment Variables. Add a new system variable named ERLANG_HOME with the value set to your Erlang installation folder (for example, C:\Program Files\Erlang OTP).

Port 5672 Already in Use

RabbitMQ uses port 5672 for AMQP connections and port 15672 for the management UI. If another application uses these ports, RabbitMQ fails to start. Check which application owns the port by running:

netstat -ano | findstr :5672

Stop the conflicting application or change RabbitMQ's port in its configuration file.

Guest Login Fails from Remote Machine

The guest user can only log in from localhost. To connect from another machine, create a new admin user:

rabbitmqctl add_user myuser mypassword
rabbitmqctl set_user_tags myuser administrator
rabbitmqctl set_permissions -p / myuser ".*" ".*" ".*"

Directory Structure on Windows

C:\Program Files\RabbitMQ Server\
   rabbitmq_server-3.x.x\
       sbin\          <-- command-line tools
       plugins\       <-- installed plugins
       etc\           <-- configuration files

Log files are stored in C:\Users\[YourUser]\AppData\Roaming\RabbitMQ\log\. Check these logs whenever something goes wrong.

Uninstalling RabbitMQ

Stop the RabbitMQ service first, then uninstall via Control Panel → Programs → Uninstall a Program. Uninstall Erlang separately the same way. Delete leftover data in C:\Users\[YourUser]\AppData\Roaming\RabbitMQ\ if you want a clean slate.

Summary

Installing RabbitMQ on Windows involves three main steps: installing Erlang, running the RabbitMQ installer, and enabling the management plugin. Once the management UI opens at http://localhost:15672, your RabbitMQ broker is ready to use. The Windows service setup means RabbitMQ starts automatically on every boot, so you do not need to remember to start it manually.

Previous lesson

Back to course

Next lesson