Aspire.Hosting.Nats
13.1.0
Prefix Reserved
dotnet add package Aspire.Hosting.Nats --version 13.1.0
NuGet\Install-Package Aspire.Hosting.Nats -Version 13.1.0
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="Aspire.Hosting.Nats" Version="13.1.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="Aspire.Hosting.Nats" Version="13.1.0" />
<PackageReference Include="Aspire.Hosting.Nats" />
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add Aspire.Hosting.Nats --version 13.1.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
#r "nuget: Aspire.Hosting.Nats, 13.1.0"
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package Aspire.Hosting.Nats@13.1.0
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=Aspire.Hosting.Nats&version=13.1.0
#tool nuget:?package=Aspire.Hosting.Nats&version=13.1.0
The NuGet Team does not provide support for this client. Please contact its maintainers for support.
Aspire.Hosting.NATS library
Provides extension methods and resource definitions for an Aspire AppHost to configure a NATS resource.
Getting started
Install the package
In your AppHost project, install the Aspire NATS Hosting library with NuGet:
dotnet add package Aspire.Hosting.Nats
Usage example
Then, in the AppHost.cs file of AppHost, add a NATS resource and consume the connection using the following methods:
var nats = builder.AddNats("nats");
var myService = builder.AddProject<Projects.MyService>()
.WithReference(nats);
Connection Properties
When you reference a NATS resource using WithReference, the following connection properties are made available to the consuming project:
NATS server
The NATS server resource exposes the following connection properties:
| Property Name | Description |
|---|---|
Host |
The hostname or IP address of the NATS server |
Port |
The port number the NATS server is listening on |
Username |
The username for authentication |
Password |
The password for authentication |
Uri |
The connection URI with the format nats://{Username}:{Password}@{Host}:{Port} |
Aspire exposes each property as an environment variable named [RESOURCE]_[PROPERTY]. For instance, the Uri property of a resource called nats becomes NATS_URI.
Additional documentation
Feedback & contributing
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 was computed. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 was computed. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
-
net8.0
- Aspire.Hosting (>= 13.1.0)
- AspNetCore.HealthChecks.Uris (>= 9.0.0)
- Google.Protobuf (>= 3.33.0)
- Grpc.AspNetCore (>= 2.71.0)
- Grpc.Net.ClientFactory (>= 2.71.0)
- Grpc.Tools (>= 2.72.0)
- Humanizer.Core (>= 2.14.1)
- JsonPatch.Net (>= 3.3.0)
- KubernetesClient (>= 18.0.5)
- Microsoft.Extensions.Configuration.Abstractions (>= 8.0.0)
- Microsoft.Extensions.Configuration.Binder (>= 8.0.2)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 8.0.2)
- Microsoft.Extensions.Diagnostics.HealthChecks (>= 8.0.22)
- Microsoft.Extensions.FileSystemGlobbing (>= 10.0.1)
- Microsoft.Extensions.Hosting (>= 8.0.1)
- Microsoft.Extensions.Hosting.Abstractions (>= 8.0.1)
- Microsoft.Extensions.Http (>= 8.0.1)
- Microsoft.Extensions.Logging.Abstractions (>= 8.0.3)
- Microsoft.Extensions.Options (>= 8.0.2)
- Microsoft.Extensions.Primitives (>= 8.0.0)
- NATS.Net (>= 2.6.11)
- Newtonsoft.Json (>= 13.0.4)
- Polly.Core (>= 8.6.4)
- Semver (>= 3.0.0)
- StreamJsonRpc (>= 2.22.23)
- System.IO.Hashing (>= 9.0.10)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories (1)
Showing the top 1 popular GitHub repositories that depend on Aspire.Hosting.Nats:
| Repository | Stars |
|---|---|
|
formcms/formcms
AI Agent: Open-source headless CMS built with ASP.NET Core (C#) and React, featuring REST APIs, GraphQL, and a GrapesJS page designer.
|
| Version | Downloads | Last Updated | |
|---|---|---|---|
| 13.1.0 | 4,658 | 12/17/2025 | |
| 13.0.2 | 1,949 | 12/4/2025 | |
| 13.0.1 | 1,952 | 11/26/2025 | |
| 13.0.0 | 2,628 | 11/11/2025 | |
| 9.5.2 | 4,279 | 10/23/2025 | |
| 9.5.1 | 2,997 | 10/3/2025 | |
| 9.5.0 | 1,984 | 9/25/2025 | |
| 9.4.2 | 3,256 | 9/2/2025 | |
| 9.4.1 | 2,973 | 8/12/2025 | |
| 9.4.0 | 817 | 7/29/2025 | |
| 9.3.1 | 8,692 | 6/10/2025 | |
| 9.3.0 | 4,443 | 5/19/2025 | |
| 9.2.1 | 911 | 4/24/2025 | |
| 9.2.0 | 932 | 4/10/2025 | |
| 9.1.0 | 2,171 | 2/25/2025 | |
| 9.0.0 | 6,117 | 11/12/2024 | |
| 9.0.0-rc.1.24511.1 | 279 | 10/15/2024 | |
| 8.2.2 | 521 | 10/24/2024 | |
| 8.2.1 | 1,028 | 9/26/2024 | |
| 8.2.0 | 883 | 8/29/2024 | |
| 8.1.0 | 373 | 7/23/2024 | |
| 8.0.2 | 502 | 6/28/2024 | |
| 8.0.1 | 810 | 5/21/2024 | |
| 8.0.0 | 353 | 5/21/2024 | |
| 8.0.0-preview.7.24251.11 | 225 | 5/7/2024 | |
| 8.0.0-preview.6.24214.1 | 321 | 4/23/2024 | |
| 8.0.0-preview.5.24201.12 | 255 | 4/9/2024 |