CommunityToolkit.Aspire.Hosting.Listmonk

listmonk hosting integration

Use this integration to model, configure, and orchestrate a listmonk newsletter and mailing list manager in an Aspire AppHost. The integration runs listmonk in a container and configures it to use a PostgreSQL database resource.

Getting started

Install the package in your AppHost project:

aspire add CommunityToolkit.Aspire.Hosting.Listmonk

Usage example

var builder = DistributedApplication.CreateBuilder(args);

var adminPassword = builder.AddParameter("listmonk-admin-password", secret: true);
var database = builder.AddPostgres("postgres")
    .AddDatabase("listmonkdb");

var listmonk = builder.AddListmonk("listmonk")
    .WithReference(database)
    .WithAdminCredentials("admin", adminPassword)
    .WithTimeZone("Etc/UTC")
    .WithUploadsVolume();

builder.AddProject<Projects.Api>("api")
    .WithReference(listmonk);

builder.Build().Run();

Connection Properties

The ListmonkResource exposes the following connection properties:

Connection properties become environment variables when referenced, for example LISTMONK_URI.

Configuration

The integration exposes listmonk's container configuration environment variables as fluent methods:

The admin credentials are only used by listmonk during first database setup. listmonk's container entrypoint also supports LISTMONK_*_FILE variables for Docker or Podman secret files. Prefer Aspire parameters for secrets in AppHost code; if a deployment requires file-based secret paths, configure those specific variables with Aspire's generic WithEnvironment API.

Additional documentation

See the listmonk documentation for listmonk configuration, administration, and operation.

Feedback & contributing

https://github.com/CommunityToolkit/Aspire