RabbitMQ Installation - jvcastaneda/DevopsToolingConfig GitHub Wiki

Here’s how to install RabbitMQ on Ubuntu 24.04:


Step 1: Update the System

Update the system packages to ensure everything is up-to-date.

sudo apt update && sudo apt upgrade -y

Step 2: Install Dependencies

Install erlang, which is required by RabbitMQ.

sudo apt install -y erlang erlang-nox

Step 3: Add RabbitMQ Repository

  1. Import RabbitMQ Signing Key:

    curl -fsSL https://packages.rabbitmq.com/rabbitmq-release-signing-key.asc | sudo tee /usr/share/keyrings/rabbitmq-archive-keyring.asc
  2. Enable RabbitMQ Repository:

    echo "deb [signed-by=/usr/share/keyrings/rabbitmq-archive-keyring.asc] https://packages.rabbitmq.com/debian/ stable main" | sudo tee /etc/apt/sources.list.d/rabbitmq.list
  3. Update Package Index:

    sudo apt update

Step 4: Install RabbitMQ

Install RabbitMQ using the following command:

sudo apt install -y rabbitmq-server

Step 5: Start and Enable RabbitMQ Service

Start RabbitMQ and enable it to start on boot:

sudo systemctl start rabbitmq-server
sudo systemctl enable rabbitmq-server

Verify the status:

sudo systemctl status rabbitmq-server

Step 6: Enable RabbitMQ Management Plugin

To manage RabbitMQ via a web interface, enable the management plugin:

sudo rabbitmq-plugins enable rabbitmq_management

The management interface will be available at:

  • URL: http://<your-server-ip>:15672
  • Default username: guest
  • Default password: guest

Step 7: Configure RabbitMQ (Optional)

  1. Change Default Password:

    sudo rabbitmqctl change_password guest <new-password>
  2. Add a New User (if you don't want to use the default guest account):

    sudo rabbitmqctl add_user <username> <password>
    sudo rabbitmqctl set_user_tags <username> administrator
    sudo rabbitmqctl set_permissions -p / <username> ".*" ".*" ".*"

Step 8: Open Firewall Ports (if necessary)

If you are using a firewall, allow the necessary ports:

sudo ufw allow 5672    # For RabbitMQ protocol (AMQP)
sudo ufw allow 15672   # For RabbitMQ Management Console

Step 9: Verify Installation

  • Check RabbitMQ status:

    sudo rabbitmqctl status
  • Access the management interface: Open http://<your-server-ip>:15672 in your browser.


Troubleshooting

  • If RabbitMQ fails to start, check the logs:
    sudo tail -f /var/log/rabbitmq/rabbit@<hostname>.log
⚠️ **GitHub.com Fallback** ⚠️