# AddListmonk

- Module: [CommunityToolkit.Aspire.Hosting.Listmonk](/reference/api/go/communitytoolkit.aspire.hosting.listmonk.md)
- Version: `13.6.1`
- Kind: `method`
- Defined on: `DistributedApplicationBuilder`
- Source: [GitHub](https://github.com/CommunityToolkit/Aspire/tree/d9c2addac6f527ef2e33712d290b84574b455a3b)

Adds a listmonk container resource to the application model. The default image is and the tag is .

## Remarks

Add a listmonk container to the application model and reference it in a .NET project.
```
var builder = DistributedApplication.CreateBuilder(args);
var db = builder.AddPostgres("postgres")
.AddDatabase("db");
var listmonk = builder.AddListmonk("listmonk")
.WithReference(db);
var api = builder.AddProject<Projects.Api>("api")
.WithReference(listmonk);
builder.Build().Run();
```

## Definition

```go
func (DistributedApplicationBuilder) AddListmonk(
    name string,
    options ...*AddListmonkOptions,
) ListmonkResource
```

## Parameters

- `name` (`string`) -- The name of the resource. This name will be used as the connection string name when referenced in a dependency.
- `options` (`...*AddListmonkOptions`) -- optional settings, see [Options](#options)

## Options

Optional parameters are passed in a trailing `options ...*AddListmonkOptions` argument.

- `Port` (`*float64`) -- The host port for the listmonk HTTP endpoint. If `null`, Aspire will assign a random host port.

## Returns

[`ListmonkResource`](/reference/api/go/communitytoolkit.aspire.hosting.listmonk/listmonkresource.md) -- A reference to the `IResourceBuilder`.

Returns a handle; failures surface later via `Err()`.

## Applies to

- `DistributedApplicationBuilder`
