# Install RabbitMQ on Google Cloud SUSE VM

## In this learning path

- [Introduction](https://learn.arm.com/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/)
- [Learn about Arm-based cloud platforms for RabbitMQ](https://learn.arm.com/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/background/)
- [Create an Azure Cobalt 100 virtual machine](https://learn.arm.com/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/azure_instance/)
- [Install RabbitMQ on Azure Cobalt 100](https://learn.arm.com/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/azure_installation/)
- [Validate RabbitMQ on Azure](https://learn.arm.com/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/azure_baseline/)
- [Create a firewall rule for RabbitMQ](https://learn.arm.com/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/gcp_firewall_setup/)
- [Create a Google Axion C4A virtual machine](https://learn.arm.com/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/gcp_instance/)
- [Install RabbitMQ on Google Cloud SUSE VM](https://learn.arm.com/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/gcp_installation/)
- [Validate RabbitMQ on Google Cloud](https://learn.arm.com/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/gcp_baseline/)
- [RabbitMQ use Case 1 - event processing with Python Workers](https://learn.arm.com/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/gcp_use_case1/)
- [RabbitMQ use case 2 - WhatsApp Notification](https://learn.arm.com/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/gcp_use_case2/)
- [Next Steps](https://learn.arm.com/learning-paths/servers-and-cloud-computing/rabbitmq-gcp/_next-steps/)

Install RabbitMQ on a Google Cloud Platform SUSE Linux Arm64 virtual machine using RPM packages for both Erlang and RabbitMQ Server.

RabbitMQ requires Erlang to be installed first.

You need:
- GCP SUSE Linux Enterprise Server (Arm64)
- Root or sudo privileges
- Outbound internet access

## Refresh system repositories

Update the system’s package list so the operating system recognizes the latest software available from its repositories.

```
sudo zypper refresh
```

## Install required system utilities

Install the basic tools needed to download and manage packages.

```
sudo zypper install -y curl wget gnupg tar socat logrotate
```

## Download Erlang RPM (Arm64)

RabbitMQ depends on Erlang. Download the Erlang RPM compatible with the Arm64 architecture.

```
wget https://github.com/rabbitmq/erlang-rpm/releases/download/v26.2.5/erlang-26.2.5-1.el8.aarch64.rpm
sudo rpm -Uvh erlang-26.2.5-1.el8.aarch64.rpm
```

### Verify Erlang installation

Confirm that Erlang is installed correctly.

```
erl -eval 'io:format("~s~n", [erlang:system_info(system_version)]), halt().' -noshell
```

You should see an output similar to:

```
Erlang/OTP 26 [erts-14.2.5] [source] [64-bit] [smp:4:4] [ds:4:4:10] [async-threads:1] [jit]
```

### Download RabbitMQ Server RPM

Download the RabbitMQ Server RPM package.

```
wget https://github.com/rabbitmq/rabbitmq-server/releases/download/v4.2.0/rabbitmq-server-4.2.0-1.el8.noarch.rpm
sudo rpm -Uvh rabbitmq-server-4.2.0-1.el8.noarch.rpm
```

**Note**  
RabbitMQ version 3.11.0 introduced significant performance enhancements for Arm-based architectures. This version needs Erlang 25.0 or later, which brings Just-In-Time (JIT) compilation and modern flame graph profiling tooling to both x86 and Arm64 CPUs. These features result in improved performance on Arm64 architectures.  
You can view [this release note](https://github.com/rabbitmq/rabbitmq-server/blob/main/release-notes/3.11.0.md).  
The [Arm Ecosystem Dashboard](https://developer.arm.com/ecosystem-dashboard/) recommends RabbitMQ version 3.11.0, the minimum recommended on Arm platforms.

### Enable and start RabbitMQ service

Enable RabbitMQ to start automatically on boot and start the service immediately.

```
sudo systemctl enable rabbitmq-server --now
```

### Verify RabbitMQ service status

Check the status of the RabbitMQ service.

```
sudo systemctl status rabbitmq-server
```

The service should be in an active (running) state.

### Enable RabbitMQ management plugin

Enable the RabbitMQ management plugin to access the web-based dashboard.

```
sudo rabbitmq-plugins enable rabbitmq_management
```

### Restart RabbitMQ

Restart RabbitMQ to apply plugin changes.

```
sudo systemctl restart rabbitmq-server
```

### Verify RabbitMQ version

Confirm the installed RabbitMQ version.

```
sudo rabbitmqctl version
```

You should see an output similar to:

```
4.2.0
```

### Access RabbitMQ management UI

Create a new RabbitMQ user for remote access.

Create a new `admin` user by running these commands on the VM:

```
sudo rabbitmqctl add_user admin StrongPassword123
sudo rabbitmqctl set_user_tags admin administrator
sudo rabbitmqctl set_permissions -p / admin ".*" ".*" ".*"
```

**Log in to Management UI**  
Now, test it from outside the VM. Open a web browser on your local machine (Chrome, Firefox, Edge, etc.) and enter the following URL and credentials in the address bar:

- **URL**: http://<VM_IP>:15672
- **Username**: admin
- **Password**: StrongPassword123

Replace `<VM_IP>` with the public IP of your GCP VM.

If everything is configured correctly, you see a RabbitMQ login page in your browser that looks like this:

![RabbitMQ Login page](https://github.com/rabbitmq/rabbitmq-server/raw/main/release-notes/3.11.0.md)

This confirms that your RabbitMQ management dashboard is operational.