KurrentDB Hosting integration reference

To get started with the Aspire KurrentDB integrations, follow the Get started with KurrentDB integrations guide.

This article includes full details about the Aspire KurrentDB Hosting integration.

Installation

To install the 📦 CommunityToolkit.Aspire.Hosting.KurrentDB NuGet package in the AppHost project:

dotnet add package CommunityToolkit.Aspire.Hosting.KurrentDB

Add KurrentDB resource

In the AppHost project, register and consume the KurrentDB integration using the AddKurrentDB extension method to add the KurrentDB container to the application builder.

var builder = DistributedApplication.CreateBuilder(args);
  
var kurrentdb = builder.AddKurrentDB("kurrentdb");
  
builder.AddProject<Projects.ExampleProject>()
       .WithReference(kurrentdb);
  
// After adding all resources, run the app...

Add KurrentDB resource with data volume

To add a data volume to the KurrentDB resource, call the WithDataVolume method:

var builder = DistributedApplication.CreateBuilder(args);
  
var kurrentdb = builder.AddKurrentDB("kurrentdb")
                       .WithDataVolume();
  
builder.AddProject<Projects.ExampleProject>()
       .WithReference(kurrentdb);
  
// After adding all resources, run the app...

The data volume is used to persist the KurrentDB data outside the lifecycle of its container. The data volume is mounted at the /var/lib/kurrentdb path in the KurrentDB container.

Add KurrentDB resource with data bind mount

To add a data bind mount to the KurrentDB resource, call the WithDataBindMount method:

var builder = DistributedApplication.CreateBuilder(args);
  
var kurrentdb = builder.AddKurrentDB("kurrentdb")
                       .WithDataBindMount(source: @"C:\KurrentDB\Data");
  
builder.AddProject<Projects.ExampleProject>()
       .WithReference(kurrentdb);
  
// After adding all resources, run the app...

Hosting integration health checks

The KurrentDB hosting integration automatically adds a health check for the KurrentDB resource. The health check verifies that the KurrentDB instance is running and that a connection can be established to it.