---
title: How to connect to a Cloud Essentials for RabbitMQ deployment
description: This page provides a guide on how to connect to a Cloud Essentials for RabbitMQ deployment using the Scaleway console.
tags:
dates:
  validation: 2025-05-06
  posted: 2025-05-06
---

import Requirements from '@macros/iam/requirements.mdx'

This page explains how to connect to a RabbitMQ deployment using the Scaleway console, using the REST API, or the Advanced Message Queuing Protocol (AMQP).

<Requirements />

- A Scaleway account logged into the [console](https://console.scaleway.com)
- [Owner](/iam/concepts/#owner) status or [IAM permissions](/iam/concepts/#permission) allowing you to perform actions in the intended Organization
- [Created a RabbitMQ deployment](/rabbitmq/how-to/create-rabbitmq-deployment/)

## How to connect to a Cloud Essentials for RabbitMQ deployment

### How to connect to a RabbitMQ dashboard

1. Click **RabbitMQ** in the **Integration Services** section of the console. The list of your RabbitMQ deployments displays.

2. Click the name of the RabbitMQ deployment you want to connect to. Its **Overview** page displays.

3. In the **Deployment information** section, click the **RabbitMQ dashboard** button. A new tab opens in your browser.

4. Enter the credentials set up during deployment creation, then click **Log in**. 

You are now connected to your Cloud Essentials for RabbitMQ deployment. Refer to the [RabbitMQ documentation](https://www.rabbitmq.com/docs/management) for comprehensive information on the RabbitMQ management dashboard.

### How to communicate with a deployment using the Management REST API

1. Click **RabbitMQ** in the **Integration Services** section of the console. The list of your RabbitMQ deployments displays.

2. From the **Network** section of the **Overview** tab of your deployment, copy the **API** endpoint.

3. In a terminal, run the following command to check RabbitMQ server health using the Management REST API. 

    Remember to replace the placeholders with the appropriate values:
      - `<username>`: the username set up when the deployment was created
      - `<password>`: the password set up when the deployment was created
      - `<rabbitmq_host>`: the API endpoint value you have just copied, the string after `amqps://` and before `:<port-number>`

    ```bash
    curl -u <username>:<password> http://<rabbitmq_host>:15672/api/healthchecks/node
    ```

    An output similar to the following displays:

    ```bash
    {
      status: ok,
      checks: [
        { check: virtual_hosts, status: ok },
        { check: listeners, status: ok },
        { check: certificate_expiry, status: ok }
      ]
    }
    ```

Refer to the [Scaleway Developer reference documentation](https://www.scaleway.com/en/developers/api/messageq) for comprehensive information on the operations available when using the Scaleway API.

### How to communicate with a deployment using the AMQP protocol

1. Click **RabbitMQ** in the **Integration Services** section of the console. The list of your RabbitMQ deployments displays.

2. From the **Network** section of the **Overview** tab of your deployment, copy the **API** endpoint.

3. In a terminal, run the following command to test connectivity using the AMQP protocol. 

    Remember to replace the placeholders with the appropriate values:
      - `<username>`: the username set up when the deployment was created
      - `<password>`: the password set up when the deployment was created
      - `<rabbitmq_host>`: the API endpoint value you have just copied, the string after `amqps://` and before `:<port-number>`

    ```bash
    python3 -c "import pika; conn = pika.BlockingConnection(pika.URLParameters('amqp://<username>:<password>@<rabbitmq_host>:5672')); print('Connection successful'); conn.close()"
    ```

    An output similar to the following displays:

    ```bash
    Connection successful
    ```

Refer to the [Scaleway Developer reference documentation](https://www.scaleway.com/en/developers/api/messageq) for comprehensive information on the operations available when using the Scaleway API.
