.NET Aspire documentation

Learn about .NET Aspire, an opinionated, cloud ready stack for building observable, production ready, distributed applications. Browse API reference, sample code, tutorials, quickstarts, conceptual articles and more.

Overview

.NET Aspire overview

Quickstart

Build your first .NET Aspire project

Concept

Distributed app host

Concept

.NET Aspire integrations

Concept

Service discovery

Deploy

Deploy a .NET Aspire project

Reference

.NET Aspire FAQ

What's new

What's new in .NET Aspire

Explore various aspects of .NET Aspire, including getting started, storage, database, messaging, caching, frameworks, deployment, and troubleshooting.

Get Started

• .NET Aspire overview
• Build your first .NET Aspire project
• Add a Node.js app to a .NET Aspire project
• .NET Aspire setup and tooling
• .NET Aspire service discovery
• .NET Aspire and launch profiles
• .NET Aspire service defaults
• .NET Aspire dashboard
• .NET Aspire local networking

Storage integrations

• Connect to storage with .NET Aspire
• Azure Blob Storage
• Azure Storage Queues
• Azure Table Storage
• Persist volume mount sample

Database integrations

• Connect to SQL Server with EF Core
• PostgreSQL database
• PostgreSQL with EF Core
• Azure Cosmos DB
• Azure Cosmos DB with EF Core
• SQL Database
• SQL Database with EF Core
• Entity Framework Core migrations
• MySqlConnector Database
• MongoDB Database

Messaging integrations

• Implement Messaging with .NET Aspire
• Azure Event Hubs
• Azure Service Bus
• Azure Web PubSub
• RabbitMQ
• Apache Kafka
• NATs

Caching integrations

• Improve app caching with .NET Aspire
• Stack Exchange Redis caching overview
• Redis caching
• Redis output caching
• Redis distributed caching

Framework integrations

• Use Orleans with .NET Aspire
• Orleans voting sample
• Use Dapr with .NET Aspire
• Dapr integration sample

Deployment

• Overview
• Deploy to Azure Container Apps
• Deploy using the Azure Developer CLI
• Integrate with Application Insights
• .NET Aspire deployment manifest format

Troubleshooting

• Allow unsecure transport
• Unable to install workload
• Untrusted localhost certificate
• The specified name is already in use
• Container runtime appears to be unhealthy
• The connection string is missing
• Ask questions on Discord
• Stack Overflow — .NET Aspire

Training

• Introduction to .NET Aspire
• Create a .NET Aspire project
• Use telemetry in a .NET Aspire project
• Use databases in a .NET Aspire project
• Improve performance with a cache in a .NET Aspire project
• Send messages with RabbitMQ in a .NET Aspire project

.NET extensions

Learn about .NET extensions, including logging, dependency injection, configuration, and more. All of which are fundamental in .NET Aspire.

Fundamentals

• Logging
• Dependency injection
• Configuration
• Make HTTP requests

Telemetry

• .NET observability with OpenTelemetry
• Networking telemetry
• .NET SDK telemetry

Resiliency

• Introduction to resilient app dev
• Build resilient HTTP apps
• Implement resiliency in a cloud-native ASP.NET Core microservice

Observability

• .NET app health checks in C#
• App health checks in ASP.NET Core
• Diagnostic tools in .NET
• Diagnostic resource monitoring in .NET

.NET community resources

Find community resources for .NET, including webcasts, shows, open-source projects, and more.

.NET

• .NET documentation
• .NET Aspire samples browser
• ASP.NET documentation
• Azure documentation
• C# documentation
• .NET Discord
• Official .NET Aspire Collection

Webcasts and shows

• Azure Friday
• The Cloud Native Show
• On .NET
• On .NET Live
• .NET Community Standup
• Welcome to .NET Aspire

Open source

• .NET Aspire
• .NET Aspire samples
• .NET samples
• .NET Platform
• .NET Runtime
• ASP.NET Core

Community

• Follow @dotnet on 𝕏
• Follow @dotnet on Mastodon
• .NET Foundation
• We Are .NET
• .NET Aspire YouTube playlist
• .NET Aspire on YouTube

API and language reference

Search the .NET API and language reference documentation.

.NET Aspire API reference

API reference documentation for .NET Aspire

.NET Platform Extensions API reference

API reference documentation for .NET Platform Extensions

.NET API reference

API reference documentation for .NET

ASP.NET Core API reference

API reference documentation for ASP.NET Core

Are you interested in contributing to the .NET Aspire docs? For more information, see our contributor guide.