Skip to main content
Published
May 12, 2026
5mo ago
Total Downloads
3.5M
3,516,609

Install

dotnet add package Aspire.Hosting.RabbitMQ --version 13.3.1
ProductVersions
.NET
net8.0

README

Aspire.Hosting.RabbitMQ library

Provides extension methods and resource definitions for an Aspire AppHost to configure a RabbitMQ resource.

Getting started

Install the package

In your AppHost project, install the Aspire RabbitMQ Hosting library with NuGet:

dotnet add package Aspire.Hosting.RabbitMQ

Usage example

Then, in the AppHost.cs file of AppHost, add a RabbitMQ resource and consume the connection using the following methods:

var rmq = builder.AddRabbitMQ("rmq");

var myService = builder.AddProject<Projects.MyService>()
                       .WithReference(rmq);

Connection Properties

When you reference a RabbitMQ resource using WithReference, the following connection properties are made available to the consuming project:

RabbitMQ server

The RabbitMQ server resource exposes the following connection properties:

Property Name Description
Host The hostname or IP address of the RabbitMQ server
Port The port number the RabbitMQ server is listening on
Username The username for authentication
Password The password for authentication
Uri The connection URI, with the format amqp://{Username}:{Password}@{Host}:{Port}

Aspire exposes each property as an environment variable named [RESOURCE]_[PROPERTY]. For instance, the Uri property of a resource called db1 becomes DB1_URI.

Additional documentation

Feedback & contributing

https://github.com/microsoft/aspire

Changes from Previous Version

No structural changes between v13.3.0 and v13.3.1.

Adoption Assessment

A verified publisher signal is available. Assess fit from the package's supported frameworks, license and dependency graph rather than popularity alone.

Compatibility metadata lists 1 target framework; confirm the exact target used by your application.The published metadata declares 30 direct dependency entries across framework groups. Inspect the resolved dependency graph for your target framework.

Related Guides & Workflows

Learn how to evaluate, integrate, or audit this package in your .NET project.