Aspire.Hosting
9.5.0
Prefix Reserved
dotnet add package Aspire.Hosting --version 9.5.0
NuGet\Install-Package Aspire.Hosting -Version 9.5.0
<PackageReference Include="Aspire.Hosting" Version="9.5.0" />
<PackageVersion Include="Aspire.Hosting" Version="9.5.0" />
<PackageReference Include="Aspire.Hosting" />
paket add Aspire.Hosting --version 9.5.0
#r "nuget: Aspire.Hosting, 9.5.0"
#:package Aspire.Hosting@9.5.0
#addin nuget:?package=Aspire.Hosting&version=9.5.0
#tool nuget:?package=Aspire.Hosting&version=9.5.0
Aspire.Hosting library
Core abstractions for the .NET Aspire application model. It provides the building blocks for the distributed application
hosting model. This package should not be referenced by AppHost projects directly. Instead use the Aspire.Hosting.AppHost
package to add a transitive referencing including custom build targets to support code generation of metadata
types for referenced .NET projects.
Developers wishing to build their own custom resource types and supporting APIs for .NET Aspire should reference this package directly.
Aspire Application Model Overview
Aspire models distributed applications as a graph of resources—services, infrastructure elements, and supporting components—using strongly-typed, extensible abstractions. Resources are inert data objects that describe capabilities, configuration, and relationships. Developers compose applications using fluent extension methods (like AddProject
, AddPostgres
, etc.), wire dependencies explicitly, and attach metadata through annotations to drive orchestration, configuration, and deployment.
Key concepts include:
- Resources: The fundamental unit representing a service or component in the app model.
- Annotations: Extensible metadata attached to resources to express capabilities and configuration.
- Fluent extension methods: APIs like
AddX
,WithReference
, andWithEnvironment
that guide correct resource composition and wiring. - Resource graph: An explicit, developer-authored Directed Acyclic Graph (DAG) that models dependencies and value flows.
- Deferral and structured values: Configuration and connectivity are expressed using structured references, allowing for deferred evaluation and environment-specific resolution at publish and run time.
- Standard interfaces: Optional interfaces enable polymorphic behaviors, such as environment wiring and endpoint exposure, for both built-in and custom resources.
- Lifecycle events and resource states: The Aspire runtime orchestrates resource startup, readiness, health, and shutdown in a predictable, observable way.
Aspire's approach ensures flexibility, strong tooling support, and clear separation between modeling, orchestration, and execution of distributed .NET applications.
For the full details and specification, see the App Model document.
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. |
-
net8.0
- AspNetCore.HealthChecks.Uris (>= 9.0.0)
- Google.Protobuf (>= 3.32.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 (>= 17.0.14)
- 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.20)
- 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)
- Newtonsoft.Json (>= 13.0.3)
- Polly.Core (>= 8.6.3)
- Semver (>= 3.0.0)
- StreamJsonRpc (>= 2.22.11)
- System.IO.Hashing (>= 9.0.8)
NuGet packages (175)
Showing the top 5 NuGet packages that depend on Aspire.Hosting:
Package | Downloads |
---|---|
Aspire.Hosting.AppHost
Core library and MSBuild logic for .NET Aspire AppHost projects. |
|
Aspire.Hosting.Azure
Azure resource types for .NET Aspire. |
|
Aspire.Hosting.Testing
Testing support for the .NET Aspire application model. |
|
Aspire.Hosting.SqlServer
Microsoft SQL Server support for .NET Aspire. |
|
Aspire.Hosting.Redis
Redis® support for .NET Aspire. |
GitHub repositories (18)
Showing the top 18 popular GitHub repositories that depend on Aspire.Hosting:
Repository | Stars |
---|---|
ChilliCream/graphql-platform
Welcome to the home of the Hot Chocolate GraphQL server for .NET, the Strawberry Shake GraphQL client for .NET and Nitro the awesome Monaco based GraphQL IDE.
|
|
oskardudycz/EventSourcing.NetCore
Examples and Tutorials of Event Sourcing in .NET
|
|
microsoft/kernel-memory
RAG architecture: index and query any data using LLM and natural language, track sources, show citations, asynchronous memory patterns.
|
|
wiremock/WireMock.Net
WireMock.Net is a flexible product for stubbing and mocking web HTTP responses using advanced request matching and response templating. Based on the functionality from http://WireMock.org, but extended with more functionality.
|
|
CodeMazeBlog/CodeMazeGuides
The main repository for all the Code Maze guides
|
|
mehdihadeli/food-delivery-microservices
🍔 A practical and cloud-native food delivery microservices, built with .Net Aspire, .Net 9, MassTransit, Domain-Driven Design, CQRS, Vertical Slice Architecture, Event-Driven Architecture, and the latest technologies.
|
|
NikiforovAll/keycloak-authorization-services-dotnet
Authentication and Authorization with Keycloak and ASP.NET Core 🔐
|
|
CommunityToolkit/Aspire
A community project with additional components and extensions for .NET Aspire
|
|
thangchung/practical-dotnet-aspire
The practical .NET Aspire builds on the coffeeshop app business domain
|
|
dotnet/systemweb-adapters
|
|
JasonBock/Rocks
A mocking library based on the Compiler APIs (Roslyn + Mocks)
|
|
hasanxdev/DispatchR
Fast, zero-alloc alternative to MediatR for .NET – minimal, blazing fast, and DI-friendly.
|
|
J-Tech-Japan/Sekiban
Sekiban - an Opinionated Event Sourcing and CQRS Framework using C#. It can store data into Azure Cosmos DB, AWS Dynamo DB or Postgres
|
|
asynkron/TraceLens
|
|
bradygaster/dotnet-cloud-native-build-2023
|
|
SnowBankSDK/foundationdb-dotnet-client
C#/.NET Binding for FoundationDB Client API
|
|
FritzAndFriends/TagzApp
An application that discovers content on social media for hashtags
|
|
aws/integrations-on-dotnet-aspire-for-aws
This repositry contains the integrations with .NET Aspire for AWS.
|
Version | Downloads | Last Updated | |
---|---|---|---|
9.5.0 | 885 | 9/25/2025 | |
9.4.2 | 189,507 | 9/2/2025 | |
9.4.1 | 267,901 | 8/12/2025 | |
9.4.0 | 297,103 | 7/29/2025 | |
9.3.2 | 178,934 | 6/20/2025 | |
9.3.1 | 667,793 | 6/10/2025 | |
9.3.0 | 524,571 | 5/19/2025 | |
9.2.1 | 410,715 | 4/24/2025 | |
9.2.0 | 458,845 | 4/10/2025 | |
9.1.0 | 679,456 | 2/25/2025 | |
9.0.0 | 1,408,031 | 11/12/2024 | |
9.0.0-rc.1.24511.1 | 37,705 | 10/15/2024 | |
9.0.0-preview.3.24210.17 | 5,330 | 4/11/2024 | |
9.0.0-preview.2.24162.2 | 2,569 | 3/12/2024 | |
9.0.0-preview.1.24113.3 | 2,223 | 2/13/2024 | |
8.2.2 | 367,376 | 10/24/2024 | |
8.2.1 | 190,819 | 9/26/2024 | |
8.2.0 | 370,879 | 8/29/2024 | |
8.1.0 | 227,939 | 7/23/2024 | |
8.0.2 | 112,144 | 6/28/2024 | |
8.0.1 | 241,974 | 5/21/2024 | |
8.0.0 | 69,415 | 5/21/2024 | |
8.0.0-preview.7.24251.11 | 38,436 | 5/7/2024 | |
8.0.0-preview.6.24214.1 | 45,647 | 4/23/2024 | |
8.0.0-preview.5.24201.12 | 35,898 | 4/9/2024 | |
8.0.0-preview.4.24156.9 | 30,944 | 3/12/2024 | |
8.0.0-preview.3.24105.21 | 39,231 | 2/13/2024 | |
8.0.0-preview.2.23619.3 | 29,189 | 12/20/2023 | |
8.0.0-preview.1.23557.2 | 73,060 | 11/14/2023 |