ubuntu/rabbitmq repository overview

ubuntu/rabbitmq is a rock for rabbitmq maintained by Canonical⁠.

RabbitMQ is a reliable and mature messaging and streaming broker, which is easy to deploy on cloud environments, on-premises, and on your local machine. It is currently used by millions worldwide.

[Learn more about rabbitmq⁠]

⁠Tags and Architectures

NOTE: These tags follow a specific naming convention that respects the concept of channels⁠.

⁠Get started

This rock's entrypoint is Pebble, a container-optimized init process that enables the orchestration of a collection of local service processes as an organized set.

[Learn more about Pebble⁠]

⁠Inspect

To view the Pebble services⁠ and checks⁠ defined in this rock:

docker run --rm ubuntu/rabbitmq:3.12-24.04_stable plan

⁠Run

To run this rock, use any of the usual container runtimes, for example, docker:

docker run --name rabbitmq-container \
    -p 5672:5672 -p 15672:15672 \
    ubuntu/rabbitmq:3.12-24.04_stable

RabbitMQ starts and exposes AMQP and HTTP management interfaces. Access AMQP on localhost:5672 and HTTP management UI on http://localhost:15672.

Note that the clients provided by RabbitMQ won't be accessible by default unless a properly defined configuration file is applied in the container. For demonstration purposes, we enable access for the default guest user from a non-localhost network by running the following commands:

$ docker exec rabbitmq-container /scripts/config-defaults.sh
$ docker exec rabbitmq-container pebble restart rabbitmq-server

CAUTION: This container is no longer production-ready if configured with /scripts/config-defaults.sh. Refer to the official documentation⁠ for production deployments.

The node status can be queried with the following command:

$ curl -u guest:guest http://localhost:15672/api/healthchecks/node

⁠Get logs

To view the logs of the running container, run:

docker exec rabbitmq-container pebble logs

Or, for a specific service:

docker exec rabbitmq-container pebble logs <service>

⁠Monitor health checks

Rocks may have predefined health checks that you can list by running:

docker exec rabbitmq-container pebble checks

The overall health of your container can be inspected via:

docker exec rabbitmq-container pebble health

⁠Configuration

⁠Environment variables

⁠Volumes

⁠Ports

[Report a bug⁠] [Contribute⁠]

Canonical is the provider of this container image. It is the user's responsibility to ensure that any use of this image complies with any relevant licenses for all software contained within, as well as with Canonical’s IP Policy⁠.