Browse resources
Type
Topic
Language
Sort by
All resources are listed below. Enable JavaScript to search, filter, and sort them.
No matching resources
Try a broader search or remove a filter.
- IntegrationLanguages: C#
.NET MAUI integration
Learn how to use the Aspire .NET MAUI integration to orchestrate .NET MAUI mobile and desktop applications alongside backend services in your AppHost.
- IntegrationLanguages: C#, TypeScript
.NET tool resources
Learn how to use the AddDotnetTool AppHost API to run .NET CLI tools as resources in your Aspire solution.
YouTube(Not) AspiriFridays - Maddy is back!
Maddy returns to the stream.
Blog💫 Welcome to the New Aspire: Your Stack, Streamlined
Aspire goes polyglot. Explore the new Aspire.dev — a unified, open-source platform for building, observing, and deploying distributed apps in any language.
- GuideLanguages: C#
Access resources in tests
Resolve and inspect Aspire AppHost resources from your tests — connection strings, endpoints, HTTP clients, and service discovery URIs for integration scenarios.
- How-toLanguages: C#, TypeScript
Add Aspire to an existing app
Add Aspire to an existing application — use aspire init with an AI coding agent or wire up the AppHost manually to bring your services into the Aspire resource model.
- GuideLanguages: C#, TypeScript
Add Dockerfiles to your app model
Add Dockerfiles to your Aspire app model with WithDockerfile — build local container images, layer arguments, and pin context paths for project and executable resources.
BlogAdding Aspire to a Python RAG Application
This blog post documents the transformation of the azure-search-openai-demo (a Python/TypeScript RAG application) through the addition of Aspire for local development and observability. It demonstrates how Aspire can enhance polyglot applications without requiring rewrites.
- GuideLanguages: C#
Advanced testing scenarios
Advanced patterns for DistributedApplicationTestingBuilder — selectively disabling resources, overriding configuration, and authoring resilient Aspire integration tests.
BlogAgentic development aspirations: build, run, observe — without more Markdown
AI agents can write code but struggle to run and test it. Aspire gives your agent a codified app model to build, run, and observe your whole stack.
- IntegrationLanguages: C#, TypeScript
AI integrations compatibility matrix
View the compatibility matrix for Aspire AI integrations including Azure OpenAI, Azure AI Inference, and IChatClient support.
BlogAnnouncing Aspire 13.2
Aspire 13.2 brings TypeScript AppHost authoring, an agent-native CLI, Foundry integration, and more.
- Guide
APIs and data access
Reference for the Aspire dashboard read and write APIs — OTLP endpoints, HTTP telemetry APIs, gRPC resource service, and authentication for programmatic access.
- Glossary
AppHost
The executable application model that declares your services, resources, connections, and local orchestration.
- Guide
AppHost configuration
Configure the Aspire AppHost — environment variables, launch profiles, network ports, container runtime selection, and the options that change orchestration behavior.
- GuideLanguages: C#, TypeScript
AppHost eventing APIs
Use the Aspire AppHost eventing APIs for lifecycle events, custom event publishing, and reactive integrations that respond to resource state transitions at runtime.
- TutorialLanguages: C#
Apply EF Core migrations in Aspire
Learn about how to apply Entity Framework Core migrations in Aspire, including running migrations at startup and publishing migration bundles as container images for deployment.
SampleLanguages: C#, TypeScriptASP.NET Core Minimal API + PostgreSQL + Vite
Todo app with C# Minimal APIs, Entity Framework Core, PostgreSQL, and React TypeScript frontend.
BlogAspire 13 – Aspireify anything
Aspire 13 is here with revamped JS and Python experiences, new AI-focused grations, and a new iteration of deployment tooling.
BlogAspire 13.1 – Our holiday gift to you
Aspire 13.1 is here with CLI-based MCP for AI agents, dashboard improvements, Azure updates, and TLS termination support.
BlogAspire 13.2: Bun Support and Container Enhancements
Aspire 13.2 keeps the JavaScript story moving with Bun for Vite, more predictable containers, and small but meaningful fixes across debugging and builds.
BlogAspire 13.2: Dashboard Gets Smarter Export and Telemetry
Aspire 13.2 brings powerful new dashboard features for exporting and importing telemetry, querying telemetry via API, and improved GenAI telemetry visualization.
BlogAspire 13.4 is here
Aspire 13.4 is here with TypeScript apphost GA, typed resource commands with results, server-side CLI log and telemetry search, more mature Kubernetes and AKS deployment, and more.
YouTubeAspire 13.5 is here!
Release highlights
BlogAspire 13.5: Fresh pixels and better workflows
Aspire 13.5 refreshes the dashboard and aspire.dev, expands the Interaction Service, adds cross-scope Azure references and Kubernetes persistent volumes, and brings live terminals into the AppHost.
YouTubeAspire 9.5 Release Party + Unboxing
Join the team for a special release party celebrating Aspire 9.5.
- CLI command
aspire add command
Learn about the aspire add command and its usage. This command adds an integration package to an Aspire AppHost project.
- CLI command
aspire agent command
Learn about the aspire agent command and its usage. This command driver manages AI agent integrations, Aspire skills, and MCP (Model Context Protocol) server operations.
- CLI command
aspire agent init command
Learn about the aspire agent init command and its usage. This command initializes AI agent configuration for detected agent environments.
- CLI command
aspire agent mcp command
Learn about the aspire agent mcp command and its usage. This command starts the MCP (Model Context Protocol) server.
- Guide
Aspire architecture overview
Learn the overall architecture of Aspire — the AppHost, resource model, orchestration, networking, dashboard, and how multi-language integrations fit together.
YouTubeAspire Bytes: withReference and withEnvironment
Aspire Bytes
- CLI command
aspire cache clear command
Learn about the aspire cache clear command and its usage. This command clears all cache entries used by the Aspire CLI.
- CLI command
aspire cache command
Learn about the aspire cache command and its usage. This command driver is used to manage disk cache for Aspire CLI operations.
- CLI command
aspire certs clean command
Learn about the aspire certs clean command and its usage. This command removes all HTTPS development certificates.
- CLI command
aspire certs command
Learn about the aspire certs command and its usage. This command manages HTTPS development certificates.
- CLI command
aspire certs trust command
Learn about the aspire certs trust command and its usage. This command trusts the HTTPS development certificate, creating one if necessary.
- CLI reference
Aspire CLI overview
Overview of the Aspire CLI, the cross-platform terminal tool for creating, running, and deploying Aspire AppHost projects from your shell.
- CLI command
aspire command
Learn about the aspire command, the generic driver for the Aspire CLI used to run, deploy, and manage AppHost projects from the terminal.
- Guide
Aspire community channels and links
Connect with the Aspire team and community across Discord, GitHub Discussions, livestreams, social channels, and contribution platforms for distributed apps.
BlogAspire Conf is Coming! Join us Live on March 23
Save the date and tune in for our free, livestream event on March 23. Discover Aspire and learn how it can transform the way you build and deploy your distributed apps and agents.
- CLI command
aspire config command
Learn about the aspire config command and its usage. This command driver is used to manage the Aspire CLI config settings.
- CLI command
aspire config delete command
Learn about the aspire config delete command and its usage. This command deletes an Aspire CLI config value by key name.
- CLI command
aspire config get command
Learn about the aspire config get command and its usage. This command gets an Aspire CLI config value by key name.
- CLI command
aspire config list command
Learn about the aspire config list command and its usage. This command lists all Aspire CLI config values.
- CLI command
aspire config set command
Learn about the aspire config set command and its usage. This command sets an Aspire CLI config value by key name.
- Glossary
Aspire dashboard
A web interface for exploring resource status, console output, structured logs, distributed traces, and metrics.
- CLI command
aspire dashboard command
Learn about the aspire dashboard command and its usage. This command is used to manage the Aspire dashboard.
- Guide
Aspire dashboard configuration reference
Configuration reference for the Aspire dashboard — OTLP endpoints, frontend authentication, resource service, telemetry limits, and standalone deployment options.
- Guide
Aspire dashboard data persistence
Learn how SQLite persistence modes, run history, retention, storage limits, and data protection work in the Aspire dashboard.
- Guide
Aspire dashboard for distributed apps
Monitor, debug, and manage your distributed applications with the Aspire dashboard — real-time telemetry, resource graphs, console logs, and OpenTelemetry support.
- Guide
Aspire dashboard for local OpenTelemetry
View application logs, distributed traces, and metrics in the Aspire dashboard. Inspect local resource health with an AppHost or receive OTLP data standalone.
- CLI command
aspire dashboard run command
Learn about the aspire dashboard run command and its usage. This command starts a standalone Aspire Dashboard instance.
- GuideLanguages: C#, Go, Python, TypeScript
Aspire dashboard security considerations
Security considerations for running the Aspire dashboard — authentication, network exposure, OTLP and resource service endpoints, and standalone hardening guidance.
- CLI command
aspire deploy command
Learn about the aspire deploy command and its usage. This command invokes the deploy pipeline step and any dependent steps registered in the app model.
- Guide
Aspire deployment overview
Ship your Aspire applications to Azure, Docker, Kubernetes, and beyond — choose a target, publish artifacts, and deploy with the Aspire CLI from a single AppHost.
- CLI command
aspire describe command
Learn about the aspire describe command which displays resource details for a running Aspire AppHost, with optional continuous streaming.
- CLI command
aspire destroy command
Learn about the aspire destroy command and its usage. This command tears down a previously deployed Aspire environment.
- CLI command
aspire do command
Learn about the aspire do command and its usage. This command executes a specific pipeline step and its dependencies.
- CLI command
aspire docs api command
Learn about the aspire docs api command and its usage. This command group is used to browse, search, and retrieve Aspire API reference material from aspire.dev.
- CLI command
aspire docs api get command
Learn about the aspire docs api get command and its usage. This command retrieves the full content of an Aspire API reference entry from aspire.dev.
- CLI command
aspire docs api list command
Learn about the aspire docs api list command and its usage. This command browses the Aspire API reference catalog under a given scope on aspire.dev.
- CLI command
aspire docs api search command
Learn about the aspire docs api search command and its usage. This command searches Aspire API reference documentation by keyword on aspire.dev.
- CLI command
aspire docs command
Learn about the aspire docs command and its usage. This command is used to browse and search Aspire documentation from aspire.dev.
- CLI command
aspire docs get command
Learn about the aspire docs get command and its usage. This command retrieves the full content of an Aspire documentation page by its slug.
BlogAspire Docs in Your Terminal (and Your AI’s Brain)
Aspire 13.2 ships aspire docs, a CLI for browsing, searching, and reading official aspire.dev docs from your terminal, with the same source of truth available to AI skills and automation.
- CLI command
aspire docs list command
Learn about the aspire docs list command and its usage. This command lists all available Aspire documentation pages from aspire.dev.
- CLI command
aspire docs search command
Learn about the aspire docs search command and its usage. This command searches Aspire documentation using relevance-ranked keyword and phrase queries.
- CLI command
aspire doctor command
Learn about the aspire doctor command and its usage. This command diagnoses Aspire environment issues and verifies setup.
- Guide
Aspire documentation home
Browse the official Aspire documentation: get started with C# and TypeScript AppHosts, model distributed apps, deploy to Azure and Kubernetes, and observe in the dashboard.
YouTubeAspire Documented with Copilot
Automatically generate living documentation from Aspire AppHost definitions using GitHub Copilot.
- CLI command
aspire export command
Learn about the aspire export command and its usage. This command exports telemetry and resource data to a zip file.
BlogAspire for JavaScript developers
Aspire 13 brings comprehensive JavaScript and TypeScript support to cloud-native development, enabling you to orchestrate Node.js applications, Vite frontends, and JavaScript services alongside your .NET projects with unified tooling and seamless integration.
- Blog
Aspire in VS Code: the 13.4 developer loop
Aspire 13.4 brings more of the local development loop into VS Code: AppHost CodeLens actions, live resource state, dashboard shortcuts, typed resource command prompts, TypeScript AppHost support, and multi-language debugging.
- CLI command
aspire init command
Learn about the aspire init command and how it uses the aspireify agent skill to wire up Aspire support in an existing codebase.
- Guide
Aspire Integrations
Connect your distributed applications to 150+ services — databases, caches, messaging, cloud platforms, and more — with a single line in your AppHost.
BlogAspire Integrations, Batteries Included
Aspire provides a batteries included approach through integrations
- Guide
Aspire Live 📺
Watch Aspire live on YouTube and Twitch — the embeds light up automatically when we go live.
- CLI command
aspire logs command
Learn about the aspire logs command and its usage. This command displays logs from resources in a running apphost.
- CLI command
aspire ls command
Learn about the aspire ls command which discovers and lists AppHost project candidates in the current directory and its subdirectories.
- CLI command
aspire mcp call command
Learn about the aspire mcp call command and its usage. This command calls an MCP tool on a running resource.
- CLI command
aspire mcp command
Learn about the aspire mcp command and its usage. This command interacts with MCP tools exposed by Aspire resources.
- GuideLanguages: C#, TypeScript
Aspire MCP server for application observability
Give coding agents MCP tools for application logs, distributed traces, and resource health. Configure optional runtime access alongside Aspire CLI skills.
- CLI command
aspire mcp tools command
Learn about the aspire mcp tools command and its usage. This command lists MCP tools exposed by running resources.
SampleLanguages: C#Aspire metrics sample app
This is a simple .NET app that shows off collecting metrics with OpenTelemetry and exporting them to Prometheus and Grafana for reporting. The instrumented app is a small web UI that emits OpenTelemetry metrics. Click around it — the Weather feed and the Auth Required flow —…
BlogAspire Multi-Repo Microservices – Windows 365 Integration Journey
How Windows 365 extends Aspire to streamline multi-repo microservice development using microservice resources, emulators, automated seed data, and cloud-based end-to-end validation.
BlogAspire Multi-repo Rollout at Scale with Agentic AI
This is part 2 blog of the windows 365 integration journey with Aspire. This blog focus to show how Windows 365 scaled Aspire adoption with reliability patterns and an agentic AI rollout system across 50+ repos.
- CLI command
aspire new command
Learn about the aspire new command and its usage. This command creates new Aspire projects or solutions.
- GuideLanguages: C#, TypeScript
Aspire on Azure: security best practices
Harden Aspire deployments to Azure with private networking, managed identities, secret stores, Key Vault references, and policy guardrails for production workloads.
- Twitch
Aspire on Twitch
Watch the official Aspire Twitch channel for live streams with the team.
- YouTube
Aspire on YouTube
Explore videos and live streams on the official Aspire YouTube channel.
SampleLanguages: C#Aspire Orleans sample app
This is a simple .NET app that shows how to use Orleans with Aspire orchestration. The voting frontend lets you create a poll, share its link, and vote on it. Vote totals are tracked by an Orleans grain and update in real time across every connected viewer. It supports both l…
- CLI command
aspire otel command
Learn about the aspire otel command and its usage. This command is used to view OpenTelemetry data (logs, spans, traces) from a running apphost.
- CLI command
aspire otel logs command
Learn about the aspire otel logs command and its usage. This command views structured logs from the Dashboard telemetry API.
- CLI command
aspire otel spans command
Learn about the aspire otel spans command and its usage. This command views spans from the Dashboard telemetry API.
- CLI command
aspire otel traces command
Learn about the aspire otel traces command and its usage. This command views traces from the Dashboard telemetry API.
- CLI command
aspire ps command
Learn about the aspire ps command which lists all running Aspire AppHost processes with their process IDs and dashboard URLs.
- CLI command
aspire publish command
Learn about the aspire publish command and its usage. This command invokes resource publishers declared by the apphost to serialize resources to disk.
- Reference
Aspire Reference
Comprehensive reference documentation for Aspire — CLI tools, APIs, and command-line reference materials.
- CLI command
aspire resource command
Learn about the aspire resource command and its usage. This command executes a command on a resource in a running apphost.
- CLI command
aspire resources command
Learn about the aspire resources command alias and migrate to the primary aspire describe command.
- CLI command
aspire restore command
Learn about the aspire restore command and its usage. This command restores dependencies and generates SDK code for an apphost.
- CLI command
aspire run command
Learn about the aspire run command, which builds and runs an Aspire AppHost project locally and streams logs and telemetry to your terminal.
- GuideLanguages: C#
Aspire SDK for distributed apps
Learn how the Aspire SDK simplifies orchestrating Aspire applications — packaging, project references, source generators, and how the SDK plugs into AppHost projects.
- Guide
Aspire SDK templates for new apps
Learn about the Aspire SDK templates — Starter app, AppHost, ServiceDefaults — and how to use them to scaffold new C# or TypeScript Aspire applications quickly.
- CLI command
aspire secret command
Learn about the aspire secret command and its usage. This command is used to manage user secrets for an Aspire AppHost.
- CLI command
aspire secret delete command
Learn about the aspire secret delete command and its usage. This command deletes a user secret for an Aspire AppHost.
- CLI command
aspire secret get command
Learn about the aspire secret get command and its usage. This command retrieves a user secret value for an Aspire AppHost.
- CLI command
aspire secret list command
Learn about the aspire secret list command and its usage. This command lists all user secrets for an Aspire AppHost.
- CLI command
aspire secret path command
Learn about the aspire secret path command and its usage. This command shows the file path where user secrets are stored for an Aspire AppHost.
- CLI command
aspire secret set command
Learn about the aspire secret set command and its usage. This command sets a user secret value for an Aspire AppHost.
SampleLanguages: C#Aspire Shop
Browse a product catalog served by the Catalog service and add items to a cart held by the Basket service. Built with Aspire. The app consists of four .NET services: AspireShop.Frontend: This is an ASP.NET Core Blazor app that displays a paginated catalog of products and allo…
- Guide
Aspire skills
Learn how Aspire skills teach AI coding agents to initialize, operate, observe, deploy, and wire Aspire apps.
- CLI command
aspire start command
Learn about the aspire start command and its usage. This command starts an AppHost in the background.
- CLI command
aspire stop command
Learn about the aspire stop command, which gracefully stops a running Aspire AppHost process so resources are torn down in the correct order.
- CLI command
aspire terminal attach command
Learn about the aspire terminal attach command, which connects your local terminal to a resource's interactive PTY session exposed using WithTerminal.
- CLI command
aspire terminal command
Use aspire terminal to list and attach to interactive resource terminals, or play tape files to automate shell and REPL checks.
- CLI command
aspire terminal ps command
Learn about the aspire terminal ps command, which lists every WithTerminal-enabled resource in the connected AppHost with grid size, attached peers, and per-replica health.
- CLI command
aspire terminal tape command
Use the aspire terminal tape command group to play tape files against existing resource terminals and automate repeatable shell or REPL checks.
- CLI command
aspire terminal tape play command
Play a tape against a running Aspire resource terminal, select a replica, configure a timeout, and capture final or per-command text screens.
- SampleLanguages: C#, TypeScript
Aspire terminals
Use interactive tools alongside your application without installing them on the host, copying connection strings, or leaving the Aspire dashboard. Each basic sample is standalone: its own API, Redis database, Dockerfile, and saved request collection. Both demonstrate the same…
- GuideLanguages: C#
Aspire troubleshooting guide
Solutions to common problems when getting started with Aspire — Docker issues, port conflicts, certificate trust, dashboard authentication, and dev container quirks.
- Glossary
Aspire Type System
A portable contract that exposes Aspire's .NET hosting APIs to supported guest languages through generated SDKs.
YouTubeAspire Unplugged with David and Maddy
Informal conversation about Aspire's vision, design decisions, and future direction.
- CLI command
aspire update command
Learn about the aspire update command and its usage. This command helps you keep your Aspire projects current by automatically detecting and updating outdated packages and templates.
- Guide
Aspire Visual Studio Code extension
Use the Aspire Visual Studio Code extension to create, configure, run, and deploy Aspire applications — with integrated CLI, dashboards, and AI-assisted workflows.
- CLI command
aspire wait command
Learn about the aspire wait command which blocks until a named resource reaches a target status, with a configurable timeout.
- Integration
Aspire.Hosting.AgentFramework.DevUI
Microsoft Agent Framework DevUI support for Aspire.
- Integration
Aspire.Hosting.Azure.FrontDoor
Azure Front Door resource types for Aspire.
- Integration
Aspire.Hosting.Azure.Provisioning.Generators
Source generators for creating bounded polyglot proxies over Azure Provisioning SDKs.
- Integration
Aspire.Hosting.Blazor
Blazor WebAssembly hosting support for Aspire.
- Integration
Aspire.Hosting.Browsers
Browser support for Aspire hosting.
- Integration
Aspire.Hosting.ClickHouse
ClickHouse hosting support for Aspire. Adds ClickHouse container resources, databases, volumes, and health checks to the Aspire app model.
- Integration
Aspire.Hosting.CodeGeneration.Go
Package Description
- Integration
Aspire.Hosting.CodeGeneration.Java
Package Description
- Integration
Aspire.Hosting.CodeGeneration.Python
Package Description
- Integration
Aspire.Hosting.CodeGeneration.Rust
Package Description
- Integration
Aspire.Hosting.CodeGeneration.TypeScript
Package Description
- Integration
Aspire.Hosting.DocumentDB
DocumentDB support for Aspire. Provides extension methods and resource definitions for an Aspire AppHost to configure a DocumentDB resource.
- Integration
Aspire.Hosting.EntityFrameworkCore
Entity Framework Core migration management support for Aspire.
- Integration
Aspire.Hosting.Integration.Analyzers
Analyzers for Aspire hosting integration authors.
- Integration
Aspire.MongoDB.EntityFrameworkCore
A MongoDB provider for Entity Framework Core that integrates with Aspire, including connection pooling, health checks, logging, and telemetry.
- Integration
Aspire.TypeSystem
Aspire Type System (ATS) APIs for Aspire polyglot support.
YouTubeAspiriFridays - Bingo Deployment, Rogue Edition
A rogue edition of deployment challenges with the Bingo app.
YouTubeAspiriFridays - Bitwarden
Welcome to the first ever AspiriFriday! Join David Fowler, Damian Edwards, and Maddy Montaquila while they try to Aspireify (aka add Aspire to) your apps, live on stream!
YouTubeAspiriFridays - Ed Keilholz (Hex Master)
David, Damian, and Maddy join Eduard Keilholz (hexmaster) to further Aspirify his app on a lively Friday stream.
YouTubeAspiriFridays - Excalidraw
The Aspire team adds Aspire to Excalidraw.
YouTubeAspiriFridays - GitHub Codespaces with Thomas Mahlberg
The team joins Thomas Mahlberg to explore Aspire with GitHub Codespaces.
YouTubeAspiriFridays - Halloween Edition
A special Halloween edition of AspiriFridays.
YouTubeAspiriFridays - Hanselman gets Aspirified
The team joins Scott Hanselman to Aspirify his application.
YouTubeAspiriFridays - James Montemagno + Feedback Flow
Damian and Maddy join James Montemagno to add Aspire to his Feedback Flow app.
YouTubeAspiriFridays - Joe Guadagno
Join Maddy, Damian, and David for the 3rd AspiriFriday where Microsoft MVP and Realtime Technologies VP Joseph Guadagno will be adding Aspire to his personal broadcast site.
YouTubeAspiriFridays - Maddy vs Deployment
Join Maddy as she tackles Aspire deployment challenges.
YouTubeAspiriFridays - Maddy vs Deployment Pt 2: The Proxies Strike Back
Maddy continues her deployment journey with proxy configurations.
YouTubeAspiriFridays - Oisin and ProjectCommander
The Aspire team joins Oisin to add Aspire to ProjectCommander.
YouTubeAspiriFridays - Sean from SCT Software
David, Damian, and Maddy join Sean Killeen from SCT Software to Aspireify his production code.
YouTubeAspiriFridays - Tommaso Stocchi and Jerry Nixon with Data API Builder
Maddy and Damian join special guests Tommaso Stocchi and Jerry Nixon to Aspirify the Azure Data API Builder after a summer break.
YouTubeAspiriFridays - Updating Samples to 13
The team works on updating Aspire samples to version 13.
- GuideLanguages: C#, TypeScript
Automate resource terminals with tape files
Run repeatable shell and REPL checks with aspire terminal tape play, wait for application output, and record terminal screens as text.
- GuideLanguages: C#
Automate terminals from your AppHost
Use TerminalService to send input, wait for output, and inspect terminal screens from AppHost code, with bounded waits and explicit ownership.
- IntegrationLanguages: C#, TypeScript
AWS integrations overview
Learn how Aspire connects to AWS with shared SDK configuration, CloudFormation and CDK resources, DynamoDB Local, and Lambda development tools.
- Integration
Azure App Service runtime configuration
Learn how apps deployed to Azure App Service via Aspire consume injected connection strings and resource references at runtime.
- IntegrationLanguages: C#, TypeScript
Azure Application Insights
Learn how to use the Azure Application Insights hosting integration to add application performance monitoring and telemetry to your Aspire application.
- IntegrationLanguages: C#, TypeScript
Azure Connector Namespace hosting integration
Model Azure Connector Namespace connections, managed MCP servers, operation allow-lists, and access policies in C# and TypeScript Aspire AppHosts.
- IntegrationLanguages: C#, TypeScript
Azure Container App Jobs
Learn how to use the Aspire Azure Container App Jobs hosting integration to deploy worker services as scheduled and event-driven jobs in Azure Container Apps.
- IntegrationLanguages: C#, TypeScript
Azure Container Registry integration overview
Use the Aspire Azure Container Registry hosting and client integrations to provision registries, push images during deployment, and pull them at runtime from your apps.
- IntegrationLanguages: C#, TypeScript
Azure Data Lake Storage
Learn how to use the Aspire Azure Data Lake Storage integration to connect to Azure Data Lake Storage Gen2 for big data analytics workloads.
- Integration
Azure Database for PostgreSQL integrations overview
Use the Aspire Azure Database for PostgreSQL hosting and client integrations to provision flexible servers, configure firewalls, and connect from C# and TypeScript apps.
- IntegrationLanguages: C#, TypeScript
Azure Front Door
Learn how to use the Aspire Azure Front Door hosting integration to put a global edge in front of your application's backends.
- IntegrationLanguages: C#, Python, TypeScript
Azure Functions runtime configuration
Learn how Azure Functions code reads Aspire-injected environment variables to wire up triggers and bindings in .NET, TypeScript/JavaScript, and Python.
- IntegrationLanguages: C#, TypeScript
Azure integrations overview
Learn how to model, configure, and deploy Azure resources in Aspire applications using Azure hosting and client integrations.
- IntegrationLanguages: C#, TypeScript
Azure Kubernetes Service (AKS) integration
Learn how to add Azure Kubernetes Service deployment support to your Aspire application using the Aspire.Hosting.Azure.Kubernetes hosting integration.
- IntegrationLanguages: C#, TypeScript
Azure Log Analytics
Learn how to use the Azure Log Analytics hosting integration to add Log Analytics workspaces to your Aspire application for centralized logging and monitoring.
- IntegrationLanguages: C#, TypeScript
Azure Virtual Network
Learn how to use the Azure Virtual Network integration to configure virtual networks, subnets, NAT gateways, network security groups, private endpoints, and network security perimeters.
- GuideLanguages: C#, TypeScript
Blazor WebAssembly integration
Enable browser telemetry for Blazor WebAssembly apps with Aspire's Blazor hosting, gateway proxying, and client service defaults.
- GuideLanguages: JavaScript
Browser app configuration
Configure generic JavaScript browser apps to send OpenTelemetry data to the Aspire dashboard with OTLP HTTP exporters.
- IntegrationLanguages: C#, TypeScript
Browser logs
Learn how to capture and configure browser console logs in Aspire using the BrowserLogs resource.
- GuideLanguages: C#
Build custom Aspire resources
Learn how to create custom resource types for the Aspire AppHost to model your application's unique services, containers, executables, and external dependencies.
- QuickstartLanguages: C#, TypeScript
Build your first Aspire app
Build your first Aspire app from scratch with either a C# or TypeScript AppHost — add resources, run the dashboard, and explore telemetry in a few minutes.
- GuideLanguages: C#
Building custom deployment pipelines
Build container images from your Aspire resources and create custom deployment pipelines — extend publishing, target new platforms, and integrate with existing CD tools.
- IntegrationLanguages: C#, TypeScript
Bun integration
Learn how to use the Aspire.Hosting.JavaScript Bun hosting APIs to orchestrate Bun applications alongside other resources in the Aspire app host.
- IntegrationLanguages: C#, TypeScript
C# file-based apps
Learn how to use the Aspire C# file-based apps hosting integration to run single .cs files without a project file alongside your other AppHost resources.
- IntegrationLanguages: C#
C# launch profiles
Learn how Aspire integrates with .NET launch profiles for C# AppHosts and service projects.
- GuideLanguages: C#
C# Service Defaults
Learn how the Aspire ServiceDefaults project for C# apps wires up OpenTelemetry, health checks, service discovery, and resilience defaults across your services.
BlogCelebrating Community Contributions in Aspire 13
Celebrates Aspire 13.0 community contributions, highlighting key PRs that improved App Service, Kusto workflows, dashboards, and cross-language support.
- GuideLanguages: C#, TypeScript
Certificate configuration
Configure HTTPS endpoints and certificate trust for Aspire resources to enable secure local development, container-to-container TLS, and trusted browser connections.
- Guide
CI/CD overview
Use the Aspire CLI as the source of truth in CI/CD and design workflows around environments, parameters, secrets, container registries, and reproducible deployments.
- Glossary
Client integration
An integration used inside an application to configure a service client, often with dependency injection, health checks, and telemetry.
YouTubeCloud-Native Development Simplified
Overview of Aspire features for building cloud-native applications with service discovery and telemetry.
- Integration
CommunityToolkit.Aspire.Bitwarden.SecretManager
An Aspire client integration for Bitwarden Secrets Manager.
- Integration
CommunityToolkit.Aspire.DuckDB.NET.Data
An Aspire client integration for the DuckDB.NET.Data package.
- Integration
CommunityToolkit.Aspire.Hosting.ActiveMQ
An Aspire hosting package for hosting ActiveMQ.
- Integration
CommunityToolkit.Aspire.Hosting.Adminer
An Aspire hosting integration for the Adminer database management container.
- Integration
CommunityToolkit.Aspire.Hosting.Azure.Extensions
Azure extensions support for Aspire.
- Integration
CommunityToolkit.Aspire.Hosting.Bitwarden.SecretManager
An Aspire hosting integration for Bitwarden Secrets Manager.
- IntegrationLanguages: JavaScript
CommunityToolkit.Aspire.Hosting.Bun
An Aspire integration for hosting Bun apps. DEPRECATED: Use Aspire.Hosting.JavaScript and builder.AddBunApp(...) instead. This package will be removed in a future release.
- Integration
CommunityToolkit.Aspire.Hosting.DbGate
An Aspire hosting integration for the DbGate database management container.
- Integration
CommunityToolkit.Aspire.Hosting.Dbx
An Aspire hosting integration for the Dbx database management container.
- Integration
CommunityToolkit.Aspire.Hosting.DuckDB
An Aspire hosting integration for providing a DuckDB database connection.
- Integration
CommunityToolkit.Aspire.Hosting.Elasticsearch.Extensions
An Aspire hosting integration for extending Elasticsearch resources with additional management tooling.
- Integration
CommunityToolkit.Aspire.Hosting.Flyway
An Aspire integration for Flyway database migration tool.
- Integration
CommunityToolkit.Aspire.Hosting.Kind
An Aspire hosting integration for Kind that manages local Kind clusters for development with Docker or Podman.
- Integration
CommunityToolkit.Aspire.Hosting.Listmonk
listmonk support for Aspire.
- Integration
CommunityToolkit.Aspire.Hosting.Logto
Aspire hosting extensions for Logto (includes PostgreSQL and Redis integration).
- Integration
CommunityToolkit.Aspire.Hosting.McpInspector
An Aspire hosting integration to run the MCP Inspector against a Model Context Protocol (MCP) server.
- Integration
CommunityToolkit.Aspire.Hosting.Minio
An Aspire hosting integration for MinIO. DEPRECATED: The MinIO OSS project has been archived and is no longer maintained. This integration is deprecated and will be removed in a future version.
- Integration
CommunityToolkit.Aspire.Hosting.Mosquitto
An Aspire hosting package for hosting the Mosquitto MQTT broker.
- Integration
CommunityToolkit.Aspire.Hosting.Ngrok
An Aspire integration for exposing hosted applications via secure, public URLs using ngrok.
- Integration
CommunityToolkit.Aspire.Hosting.OpenTelemetryCollector
An Aspire hosting integration to add an OpenTelemetry Collector into the OTLP pipeline.
- Integration
CommunityToolkit.Aspire.Hosting.PapercutSmtp
An Aspire component leveraging Papercut SMTP container.
- Integration
CommunityToolkit.Aspire.Hosting.Posta
An Aspire hosting integration for Posta.
- Integration
CommunityToolkit.Aspire.Hosting.RedPanda
An Aspire hosting package for the Redpanda Kafka-compatible streaming platform.
- Integration
CommunityToolkit.Aspire.Hosting.RustFs
An Aspire hosting integration for the RustFS S3-compatible object storage container.
- Integration
CommunityToolkit.Aspire.Hosting.SeaweedFS
Provides extension methods and resource definitions for the Aspire AppHost to support running SeaweedFS containers with an S3-compatible API.
- Integration
CommunityToolkit.Aspire.Hosting.Sftp
Aspire hosting integration for the atmoz SFTP container image.
- Integration
CommunityToolkit.Aspire.Hosting.Solr
An Aspire hosting integration for Apache Solr.
- Integration
CommunityToolkit.Aspire.Hosting.Squad
An Aspire hosting integration for Squad AI-agent teams. Models a .squad/ workspace as a first-class Aspire resource that auto-discovers the team roster and exposes it via WithReference for downstream services.
- Integration
CommunityToolkit.Aspire.Hosting.StableDiffusionCpp
An Aspire hosting integration for the stable-diffusion.cpp image generation server.
- Integration
CommunityToolkit.Aspire.Hosting.Stripe
An Aspire integration for the Stripe CLI for local webhook forwarding and testing.
- Integration
CommunityToolkit.Aspire.Hosting.Umami
Umami support for Aspire.
- Integration
CommunityToolkit.Aspire.Hosting.Zitadel
An Aspire hosting integration for the ZITADEL identity and access management container.
- Integration
CommunityToolkit.Aspire.Logto.Client
An Aspire client integration for Logto that registers OpenID Connect (OIDC) or JWT authentication services in the dependency injection container.
- Integration
CommunityToolkit.Aspire.Minio.Client
An Aspire client integration for MinIO. DEPRECATED: The MinIO OSS project has been archived and is no longer maintained. This integration is deprecated and will be removed in a future version.
- Integration
CommunityToolkit.Aspire.Posta
An Aspire client integration for the Posta email delivery platform.
- Integration
CommunityToolkit.Aspire.SeaweedFS.Client
An Aspire client integration for SeaweedFS using the AWSSDK.S3 client.
- Integration
CommunityToolkit.Aspire.Sftp
An SFTP client that integrates with Aspire, including health checks, logging, and telemetry.
- DiagnosticLanguages: C#
Compiler Error ASPIRE006
Learn what causes Aspire compiler error ASPIRE006 — invalid AppHost resource names — and how to fix the issue by following Aspire naming constraints and conventions.
- Diagnostic
Compiler Error ASPIRE007
Learn what causes the Aspire compiler error ASPIRE007 — the project is missing a required Aspire.AppHost.Sdk with a version of at least 9.0.0.
- Diagnostic
Compiler Error ASPIRE008
Learn what causes the Aspire compiler error ASPIRE008 — the project requires GenerateAssemblyInfo to be enabled for the AppHost to function correctly.
- Diagnostic
Compiler Error ASPIRE009
Learn what causes Aspire compiler error ASPIRE009 — the AppHost is configured to use the Aspire CLI bundle, but the bundle could not be resolved — and how to fix it.
- Diagnostic
Compiler Error ASPIRE011
Learn what causes Aspire compiler error ASPIRE011 when Dnx or DnxPinned mode can't find the dnx command, and how to correct it.
- DiagnosticLanguages: C#
Compiler Error ASPIREACADOMAINS001
Learn what causes the Aspire compiler error ASPIREACADOMAINS001 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Error ASPIREACAEXPRESS001
Learn what causes the Aspire compiler error ASPIREACAEXPRESS001 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Error ASPIREACANAMING002
Learn what causes the Aspire compiler error ASPIREACANAMING002 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Error ASPIREAZURE001
Learn what causes the Aspire compiler error ASPIREAZURE001 — publishers are for evaluation purposes only and are subject to change or removal in future updates.
- DiagnosticLanguages: C#
Compiler Error ASPIREAZURE002
Learn what causes the Aspire compiler error ASPIREAZURE002 and how to fix it so your AppHost builds cleanly. Resolve or suppress it to keep your Aspire build.
- DiagnosticLanguages: C#
Compiler Error ASPIREAZURE003
Learn what causes the Aspire compiler error ASPIREAZURE003 and how to fix it so your AppHost builds cleanly. Resolve or suppress it to keep your Aspire build.
- DiagnosticLanguages: C#
Compiler Error ASPIREBROWSERLOGS001
Learn what causes the Aspire compiler error ASPIREBROWSERLOGS001 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Error ASPIRECOMPUTE001
Learn what causes the Aspire compiler error ASPIRECOMPUTE001 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Error ASPIRECOSMOSDB001
Learn what causes the Aspire compiler error ASPIRECOSMOSDB001 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Error ASPIRECSHARPAPPS001
Learn what causes the Aspire compiler error ASPIRECSHARPAPPS001 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Error ASPIREEXPORT001
Learn what causes the Aspire compiler error ASPIREEXPORT001 — a method marked with [AspireExport] must be static — and how to fix it in your AppHost.
- DiagnosticLanguages: C#
Compiler Error ASPIREEXPORT002
Learn what causes the Aspire compiler error ASPIREEXPORT002 — the export ID format is invalid and must be a valid identifier.
- DiagnosticLanguages: C#
Compiler Error ASPIREEXPORT003
Learn what causes the Aspire compiler error ASPIREEXPORT003 — the return type of an [AspireExport] method is not ATS-compatible.
- DiagnosticLanguages: C#
Compiler Error ASPIREEXPORT004
Learn what causes the Aspire compiler error ASPIREEXPORT004 — a parameter type in an [AspireExport] method is not ATS-compatible.
- DiagnosticLanguages: C#
Compiler Error ASPIREEXPORT015
Learn what causes the Aspire compiler error ASPIREEXPORT015 — AspireExport Description is compatibility metadata — and how to fix it.
- DiagnosticLanguages: C#
Compiler Error ASPIREHOSTINGPYTHON001
Learn what causes the Aspire compiler error ASPIREHOSTINGPYTHON001 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Error ASPIREPERSISTENCE001
Learn what causes the Aspire compiler error ASPIREPERSISTENCE001 and how to suppress it when using experimental resource lifetime APIs.
- Diagnostic
Compiler Error ASPIREPIPELINES001
Learn what causes the Aspire compiler error ASPIREPIPELINES001 and how to fix it so your AppHost builds cleanly.
- Diagnostic
Compiler Error ASPIREPIPELINES002
Learn what causes the Aspire compiler error ASPIREPIPELINES002 and how to fix it so your AppHost builds cleanly.
- Diagnostic
Compiler Error ASPIREPIPELINES003
Learn what causes the Aspire compiler error ASPIREPIPELINES003 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Error ASPIREPROXYENDPOINTS001
Learn what causes the Aspire compiler error ASPIREPROXYENDPOINTS001 and how to fix it so your AppHost builds cleanly.
- Diagnostic
Compiler Error ASPIREPUBLISHERS001
Learn what causes the Aspire compiler error ASPIREPUBLISHERS001 and how to fix it so your AppHost builds cleanly.
- Diagnostic
Compiler Warning ASPIRE001
Learn what causes the Aspire compiler warning ASPIRE001 — the code language isn't fully supported by Aspire — and how to fix it in your AppHost.
- Diagnostic
Compiler Warning ASPIRE002
Learn what causes the Aspire compiler warning ASPIRE002 and how to fix it so your AppHost builds cleanly. Resolve or suppress it to keep your Aspire build.
- Diagnostic
Compiler Warning ASPIRE003
Learn what causes the Aspire compiler warning ASPIRE003 — this project requires Visual Studio version '17.10' or higher to work properly.
- Diagnostic
Compiler Warning ASPIRE004
Learn what causes the Aspire compiler warning ASPIRE004 — project is referenced by an Aspire Host project, but it is not an executable.
- Diagnostic
Compiler Warning ASPIRE010
Learn what causes Aspire compiler warning ASPIRE010 — the AppHost has opted out of the Aspire CLI bundle — and how to enable or suppress it.
- DiagnosticLanguages: C#
Compiler Warning ASPIREACANAMING001
Learn what causes the Aspire compiler warning ASPIREACANAMING001 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Warning ASPIREBLAZOR001
Learn what causes the Aspire compiler warning ASPIREBLAZOR001 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Warning ASPIRECERTIFICATES001
Learn what causes the Aspire compiler warning ASPIRECERTIFICATES001 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Warning ASPIRECOMMAND001
Learn what causes the Aspire compiler warning ASPIRECOMMAND001 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Warning ASPIRECOMPUTE002
Learn what causes the Aspire compiler warning ASPIRECOMPUTE002 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Warning ASPIRECOMPUTE003
Learn what causes the Aspire compiler warning ASPIRECOMPUTE003 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Warning ASPIRECONTAINERRUNTIME001
Learn what causes the Aspire compiler warning ASPIRECONTAINERRUNTIME001 — the container runtime APIs are experimental and subject to change.
- DiagnosticLanguages: C#
Compiler Warning ASPIRECONTAINERSHELLEXECUTION001
Learn what causes the Aspire compiler warning ASPIRECONTAINERSHELLEXECUTION001 — the container shell execution property is experimental and subject to change.
- DiagnosticLanguages: C#, TypeScript
Compiler Warning ASPIREDOCKERFILEBUILDER001
Learn what causes the Aspire compiler warning ASPIREDOCKERFILEBUILDER001 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Warning ASPIREDOTNETPROJECT001
Learn why Aspire 13.6 removed ASPIREDOTNETPROJECT001 from the prerelease Dotnet and Blazor hosting packages while their APIs remain unstable.
- DiagnosticLanguages: C#
Compiler Warning ASPIREDOTNETTOOL001
Learn what causes the Aspire compiler warning ASPIREDOTNETTOOL001 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Warning ASPIREDURABLETASK001
Learn what causes the Aspire compiler warning ASPIREDURABLETASK001 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Warning ASPIREEXPORT005
Learn what causes the Aspire compiler warning ASPIREEXPORT005 — an [AspireUnion] attribute requires at least 2 types — and how to fix it in your AppHost.
- DiagnosticLanguages: C#
Compiler Warning ASPIREEXPORT006
Learn what causes the Aspire compiler warning ASPIREEXPORT006 — a type in an [AspireUnion] attribute is not ATS-compatible — and how to fix it in your AppHost.
- DiagnosticLanguages: C#
Compiler Warning ASPIREEXPORT007
Learn what causes the Aspire compiler warning ASPIREEXPORT007 — duplicate export ID detected for the same target type — and how to fix it in your AppHost.
- DiagnosticLanguages: C#
Compiler Warning ASPIREEXPORT008
Learn what causes the Aspire compiler warning ASPIREEXPORT008 — a public extension method on an exported type is missing [AspireExport] or [AspireExportIgnore].
- DiagnosticLanguages: C#
Compiler Warning ASPIREEXPORT009
Learn what causes the Aspire compiler warning ASPIREEXPORT009 — the export name may collide with names from other integrations.
- DiagnosticLanguages: C#
Compiler Warning ASPIREEXPORT010
Learn what causes the Aspire compiler warning ASPIREEXPORT010 — a synchronous callback parameter is invoked inline and may deadlock in multi-language app hosts.
- DiagnosticLanguages: C#
Compiler Warning ASPIREEXPORT013
Learn what causes the Aspire compiler warning ASPIREEXPORT013 — a polyglot capability ID is defined by multiple exports in the same assembly.
- DiagnosticLanguages: C#
Compiler Warning ASPIREEXPORT016
Learn what causes the Aspire compiler warning ASPIREEXPORT016 — a get-only mutable collection on an AspireDto — and how to fix it.
- DiagnosticLanguages: C#
Compiler Warning ASPIREEXTENSION001
Learn what causes the Aspire compiler warning ASPIREEXTENSION001 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Warning ASPIREFILESYSTEM001
Learn what causes the Aspire compiler warning ASPIREFILESYSTEM001 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Warning ASPIREINTERACTION001
Learn what causes the Aspire compiler warning ASPIREINTERACTION001 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Warning ASPIREJAVASCRIPT001
Learn what causes the Aspire compiler warning ASPIREJAVASCRIPT001 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Warning ASPIREMCP001
Learn what causes the Aspire compiler warning ASPIREMCP001 and how to fix it so your AppHost builds cleanly. Resolve or suppress it to keep your Aspire build.
- DiagnosticLanguages: C#
Compiler Warning ASPIREPIPELINES004
Learn what causes the Aspire compiler warning ASPIREPIPELINES004 — the pipeline output service APIs are experimental and subject to change.
- DiagnosticLanguages: C#
Compiler Warning ASPIREPOSTGRES001
Learn what causes the Aspire compiler warning ASPIREPOSTGRES001 — the PostgreSQL MCP integration APIs are experimental and subject to change.
- DiagnosticLanguages: C#
Compiler Warning ASPIREPROBES001
Learn what causes the Aspire compiler warning ASPIREPROBES001 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Warning ASPIREPROCESSCOMMAND001
Learn what causes the Aspire compiler warning ASPIREPROCESSCOMMAND001 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Warning ASPIREPROJECTS001
Learn what causes the Aspire compiler warning ASPIREPROJECTS001 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Warning ASPIRERADIUS003
Learn what causes the Aspire compiler warning ASPIRERADIUS003 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Warning ASPIRERADIUS004
Learn what causes the Aspire compiler warning ASPIRERADIUS004 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Warning ASPIRERADIUS006
Learn what causes the Aspire compiler warning ASPIRERADIUS006 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Warning ASPIRERADIUS057
Learn what causes the Aspire compiler warning ASPIRERADIUS057 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Warning ASPIRETERMINAL001
Learn what causes the Aspire compiler warning ASPIRETERMINAL001 and how to fix it so your AppHost builds cleanly.
- DiagnosticLanguages: C#
Compiler Warning ASPIREUSERSECRETS001
Learn what causes the Aspire compiler warning ASPIREUSERSECRETS001 — the user secrets manager APIs are experimental and subject to change.
- DiagnosticLanguages: C#
Compiler Warning ASPIREWATCH001
Learn what causes the Aspire compiler warning ASPIREWATCH001 and how to fix it so your AppHost builds cleanly.
- IntegrationLanguages: C#, TypeScript
Compose Azure infrastructure with Bicep helpers
Use Aspire's Bicep helpers to compose deployment-time values, customize Azure Storage and Key Vault, and map each helper to the Azure Provisioning SDK.
- Glossary
Compute environment
A resource representing a deployment target that contributes pipeline steps for compatible application resources.
- CLI reference
Configuration settings
Learn about Aspire CLI configuration, the aspire.config.json settings and their default values, and the JSON Schema for editor completions and validation.
- IntegrationLanguages: C#, TypeScript
Configure Azure Container Apps environments
Learn how to configure Azure Container Apps environment settings, scaling rules, and ingress for Aspire AppHost projects deployed to Azure.
- GuideLanguages: C#, TypeScript
Configure Gateway API on AKS
Expose Aspire services on AKS using Kubernetes Gateway API with Application Gateway for Containers — routing, TLS, and per-resource gateway annotations.
- GuideLanguages: C#, TypeScript
Configure Ingress on AKS
Configure Kubernetes Ingress on AKS with Application Gateway for Containers and automatic TLS — route Aspire services, manage hostnames, and harden public exposure.
- IntegrationLanguages: C#, TypeScript
Configure PowerShell scripts in the AppHost
Configure PowerShell runspace pools, scripts, arguments, dependencies, dashboard actions, and lifecycle behavior in Aspire.
- GuideLanguages: C#, TypeScript
Configure resource lifetimes in Aspire
Learn how session, persistent, resource-scoped, and parent-process lifetimes, plus explicit start, control Aspire containers, executables, and projects.
- IntegrationLanguages: C#, TypeScript
Configure SQL Database Projects in AppHost
Reference the SQL Database Projects AppHost APIs for deploying DACPAC files, project outputs, and package schemas to SQL Server.
SampleLanguages: C#Configuring health checks & running the ASP.NET Core HealthChecksUI container with Aspire
This sample demonstrates configuring ASP.NET Core Health Checks and running the ASP.NET Core HealthChecksUI container with Aspire. The sample is based on the Aspire Starter App project template and thus consists of a frontend web app that communicates with a backend ASP.NET C…
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect Aspire apps to Dapr sidecars
Use Aspire-injected Dapr HTTP and gRPC endpoints from C#, TypeScript, Python, and Go apps with the official Dapr SDKs.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect Aspire apps to Data API Builder
Resolve Data API Builder through Aspire service discovery and call its REST or GraphQL endpoints from C#, TypeScript, Python, and Go.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect Aspire apps to LavinMQ
Use LavinMQ connection properties from C#, TypeScript, Python, and Go apps with RabbitMQ-compatible AMQP 0-9-1 clients.
- IntegrationLanguages: C#, Python, TypeScript
Connect Blazor apps and APIs
Learn which service discovery connection properties Aspire exposes for Blazor resources and how to wire Blazor apps to APIs through your AppHost.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Apache Kafka
Learn how to connect to Apache Kafka from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Azure AI Foundry
Learn how to connect to Azure AI Foundry from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Azure AI Inference
Learn how to connect to Azure AI Inference from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Azure AI Search
Learn how to connect to Azure AI Search from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Azure App Configuration
Learn how to connect to Azure App Configuration from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Azure Blob Storage
Learn how to connect to Azure Blob Storage from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Azure Cache for Redis
Learn how to connect to Azure Cache for Redis from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Azure Cosmos DB
Learn how to connect to Azure Cosmos DB from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#
Connect to Azure Cosmos DB with EF Core
Learn how to register a DbContext for Azure Cosmos DB in C# consuming apps using the Aspire EF Core Azure Cosmos DB client integration.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Azure Database for PostgreSQL
Learn how to connect to Azure Database for PostgreSQL from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Azure Event Hubs
Learn how to connect to Azure Event Hubs from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Azure Key Vault
Learn how to connect to Azure Key Vault from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Azure OpenAI
Learn how to connect to Azure OpenAI from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#
Connect to Azure PostgreSQL with EF Core
Learn how to connect to Azure PostgreSQL from C# consuming apps in an Aspire solution using Entity Framework Core.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Azure Queue Storage
Learn how to connect to Azure Queue Storage from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Azure Service Bus
Learn how to connect to Azure Service Bus from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Azure SignalR Service
Learn how to connect to Azure SignalR Service from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Azure SQL Database
Learn how to connect to Azure SQL Database from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#
Connect to Azure SQL with EF Core
Learn how to connect to an Azure SQL database from a C# consuming app in an Aspire solution using the Entity Framework Core client integration.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Azure Table Storage
Learn how to connect to Azure Table Storage from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Azure Web PubSub
Learn how to connect to Azure Web PubSub from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to ClickHouse
Learn how to connect to ClickHouse from C#, Go, Python, and TypeScript consuming apps in an Aspire solution in your Aspire AppHost.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Elasticsearch
Learn how to connect to Elasticsearch from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to flagd
Learn how to connect to flagd from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Garnet
Learn how to connect to Garnet from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to GitHub Models
Learn how to connect to the GitHub Models API from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to GO Feature Flag
Learn how to connect to a GO Feature Flag relay proxy from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Java, Python, TypeScript
Connect to Java apps
Learn how other apps call your Java apps through Aspire, and how Spring Boot, Quarkus, and plain Java apps read the URLs and connection details that Aspire injects.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to KurrentDB
Learn how to connect to KurrentDB from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Mailpit
Learn how to connect to Mailpit from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Meilisearch
Learn how to connect to Meilisearch from C#, Go, Python, and TypeScript consuming apps in an Aspire solution in your Aspire AppHost.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Milvus
Learn how to connect to Milvus from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to MongoDB
Learn how to connect to MongoDB from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to MySQL
Learn how to connect to MySQL from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#
Connect to MySQL with EF Core
Learn how to register an EF Core DbContext for MySQL from a C# consuming app in an Aspire solution, including connection properties, configuration, health checks, and telemetry.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to NATS
Learn how to connect to NATS from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Ollama
Learn how to connect to Ollama from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to OpenAI
Learn how to connect to the OpenAI API from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#
Connect to Oracle with EF Core
Learn how to use the Aspire Oracle Entity Framework Core client integration to connect to an Oracle database from a C# consuming app in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to PostgreSQL
Learn how to connect to PostgreSQL from C#, Go, Python, and TypeScript consuming apps in an Aspire solution in your Aspire AppHost.
- IntegrationLanguages: C#
Connect to PostgreSQL with EF Core
Learn how to connect a .NET consuming app to a PostgreSQL database using the Aspire PostgreSQL Entity Framework Core client integration.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Qdrant
Learn how to connect to Qdrant from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to RabbitMQ
Learn how to connect to RabbitMQ from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to RavenDB
Learn how to connect to RavenDB from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Redis
Learn how to connect to Redis from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#
Connect to Redis distributed caching
Learn how to register IDistributedCache backed by Redis in a consuming C# app using the Aspire.StackExchange.Redis.DistributedCaching client integration.
- IntegrationLanguages: C#
Connect to Redis output caching
Learn how to register an ASP.NET Core OutputCacheStore backed by Redis using Aspire.StackExchange.Redis.OutputCaching — including configuration, health checks, telemetry, and usage with the [OutputCache] attribute.
- IntegrationLanguages: C#, Go, Python, Rust, TypeScript
Connect to Rust apps
Learn how other apps call your Rust apps through Aspire, and how Rust apps read the URLs and connection details that Aspire injects and send telemetry to the dashboard.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Seq
Learn how to connect to Seq from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to SQL Server
Learn how to connect to SQL Server from C#, Go, Python, and TypeScript consuming apps in an Aspire solution in your Aspire AppHost.
- IntegrationLanguages: C#
Connect to SQL Server (EF Core)
Learn how to connect to SQL Server from C# consuming apps using Entity Framework Core in an Aspire solution in your Aspire AppHost.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to SQLite
Learn how to connect to SQLite from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to SurrealDB
Learn how to connect to SurrealDB from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- IntegrationLanguages: C#, Go, Python, TypeScript
Connect to Valkey
Learn how to connect to Valkey from C#, Go, Python, and TypeScript consuming apps in an Aspire solution.
- Glossary
Connection string
A formatted value containing the address and options a client needs to connect to a database, cache, or similar service.
- GuideLanguages: C#, TypeScript
Container files
Inject files and directories into Aspire container resources at development and publish time using WithContainerFiles, with options for source paths and permissions.
- Container images
Container images
A complete reference of every container image used by Aspire hosting integrations — grouped by category, with registry, tag, and the AppHost API that introduces each.
- GuideLanguages: C#, TypeScript
Container networking
Learn how the Aspire DCP container tunnel enables reliable container-to-host and container-to-container networking in development, including ports and service discovery.
- GuideLanguages: C#, TypeScript
Container registry configuration
Configure container registries for Aspire — generic registries, Docker Hub, Azure Container Registry, GitHub Container Registry, and per-resource image tagging.
- GuideLanguages: C#, JavaScript, TypeScript
Contributor guide for aspire.dev
Learn how to contribute to aspire.dev: clone the repo, run the docs site locally, write Starlight MDX, follow the style guide, and open a pull request.
- TutorialLanguages: C#
Create custom client integrations
Learn how to create a custom Aspire client integration for an existing containerized application in your Aspire AppHost.
- TutorialLanguages: C#, TypeScript
Create custom hosting integrations
Learn how to create a custom Aspire hosting integration for an existing containerized application in your Aspire AppHost.
- GuideLanguages: C#
Create ephemeral terminals from your AppHost
Use TerminalService to launch interactive processes, display docked terminals, and manage their lifetime independently of resources in your AppHost.
- GuideLanguages: C#, TypeScript
Custom HTTP commands
Create custom HTTP commands in Aspire to invoke service endpoints from the dashboard and CLI — refresh caches, run admin actions, and integrate with internal tools.
- GuideLanguages: C#, TypeScript
Custom resource commands
Create custom resource commands in Aspire to add buttons and actions to the dashboard — refresh data, run scripts, and trigger workflows directly from the resource graph.
- IntegrationLanguages: C#, TypeScript
Customize Azure resources
Learn how to customize Azure resource provisioning, existing resources, role assignments, naming, and outputs in Aspire.
- Glossary
DAG
A directed acyclic graph: nodes connected by directional edges, with no path that loops back to its starting node.
- SampleLanguages: C#
Database migrations with Entity Framework Core sample app
This sample demonstrates how to use Entity Framework Core's migrations feature with Aspire. The sample has three important projects: DatabaseMigrations.ApiService - A web app that uses the database. DatabaseMigrations.MigrationService - A background worker app that applies mi…
- Guide
Debug app failures with AI coding agents
Investigate a local request failure using the same application logs, traces, and resource health in the Aspire dashboard and coding-agent CLI or MCP tools.
- IntegrationLanguages: C#
Default Azure credential
Learn about the default credential behavior in Aspire Azure client integrations and how to customize it in your Aspire AppHost.
- Glossary
Deferred evaluation
Resolving or computing a value only when the information needed to produce it is available.
- GuideLanguages: C#
Define custom resource URLs
Create custom resource URLs in Aspire so the dashboard, MCP server, and AI coding agents can deep-link to admin tools, health endpoints, and external dashboards.
- GuideLanguages: C#, TypeScript
Deploy Aspire applications with Radius
Publish Aspire apps to Radius, understand recipe-backed connection values and credentials, and resolve deployment and publish diagnostics.
- GuideLanguages: C#, JavaScript, TypeScript
Deploy JavaScript apps
Learn the main production deployment models for JavaScript app resources in Aspire — Next.js, Vite, SSR frameworks, container images, and CDN-fronted hosting targets.
- Guide
Deploy to Azure
Learn how Azure deployment works in Aspire, the shared prerequisites, and how to choose between Azure App Service, Container Apps, and AKS for production workloads.
- GuideLanguages: C#, TypeScript
Deploy to Azure App Service
Deploy Aspire applications to Azure App Service with the aspire deploy command — plans, containers, configuration, slot deployments, and CI/CD integration.
- GuideLanguages: C#, TypeScript
Deploy to Azure Container Apps
Deploy Aspire applications to Azure Container Apps with the aspire deploy command — environments, revisions, scaling, ingress, and secret-backed configuration.
- GuideLanguages: C#, TypeScript
Deploy to Azure Container Apps Sandboxes
Deploy Aspire compute resources to Azure Container Apps Sandboxes with aspire deploy — sandbox groups, tiers, auto-suspend, endpoint access, and identity.
- GuideLanguages: C#, TypeScript
Deploy to Azure Kubernetes Service (AKS)
Deploy your Aspire application to Azure Kubernetes Service with full provisioning of AKS clusters, container registries, ingress, identity, and observability.
- GuideLanguages: C#, TypeScript
Deploy to Docker Compose
Publish and deploy your Aspire application using Docker Compose with Docker or Podman — generate compose files, build images, and orchestrate multi-service production runs.
- Guide
Deploy to Kubernetes
Deploy Aspire applications to Kubernetes — whether you manage your own cluster or use Azure Kubernetes Service, Helm-based publishing, and CI/CD integrations.
- GuideLanguages: C#, TypeScript
Deploy to Kubernetes clusters
Publish and deploy your Aspire application to an existing Kubernetes cluster using Helm — generated charts, values overrides, secrets, and release management workflows.
- TutorialLanguages: C#, TypeScript
Deploy your first Aspire app
Deploy your first Aspire application end to end — choose a target (Azure, Kubernetes, or Docker Compose), publish artifacts, and run aspire deploy from a C# or TypeScript AppHost.
- Glossary
Deployment pipeline
A dependency-aware set of steps that builds, publishes, or deploys resources from the Aspire application model.
- Guide
Deployment state caching
Learn how the aspire deploy command manages deployment state through cached configuration files — keys, invalidation, and per-environment override behavior.
- Quickstart
Dev Containers in Visual Studio Code
Use Aspire with Visual Studio Code Dev Containers to build and run multi-language apps in a reproducible environment with the CLI and dashboard ready.
- IntegrationLanguages: C#, TypeScript
Dev Tunnels integration
Learn how to use the Dev Tunnels integration for exposing local web services to the internet in your Aspire AppHost.
- DiagnosticLanguages: C#
Diagnostics overview
Learn about the diagnostics tools and features available in Aspire — analyzers, compiler errors, the dashboard, structured telemetry, and troubleshooting workflows.
- GuideLanguages: C#
Display interactive terminals in dialogs
Use PromptTerminalAsync to display interactive tools in dashboard dialogs, coordinate cancellation, and manage terminal and interaction lifetimes.
- Glossary
Distributed application
An application whose parts communicate across process or network boundaries, rather than running as a single unit.
BlogDistributed multi-agent systems with Aspire and Microsoft Agent Framework
Learn how Aspire, Microsoft Agent Framework, and Microsoft Foundry model, run, observe, and publish a distributed multi-agent AlpineAI ski resort demo.
- Guide
Docker Compose to Aspire AppHost reference
Quick reference for converting Docker Compose YAML syntax to Aspire AppHost API calls — services, networks, volumes, environment variables, and health checks.
- IntegrationLanguages: C#, TypeScript
Docker integration
Learn how to use the Aspire Docker hosting integration to deploy your app with Docker Compose.
- Integration
EF Core Azure Cosmos DB integrations overview
Use the Aspire Entity Framework Core Azure Cosmos DB integrations to model your DbContext, provision a Cosmos DB account, and connect from C# apps with health checks.
- Integration
EF Core Azure PostgreSQL integrations overview
Use the Aspire EF Core Azure PostgreSQL hosting and client integrations to provision flexible servers and connect from your C# DbContext with resilience and telemetry.
- Glossary
Emulator pattern
Replaces a supported cloud resource with a local emulator for development while keeping the resource in the application model.
- Guide
Enable browser telemetry
Enable browser telemetry in the Aspire dashboard to capture client-side OpenTelemetry logs, traces, and metrics from front-end JavaScript apps.
- Glossary
Endpoint
A named network access point on a resource, describing how clients can reach it through a scheme, host, and port.
- IntegrationLanguages: C#
Entity Framework Core integrations overview
Learn how Aspire Entity Framework Core integrations simplify pooled DbContext registration, health checks, tracing, and connection resiliency for SQL Server, PostgreSQL, MySQL, Oracle, Cosmos DB, and MongoDB.
- Glossary
Environment variable
A process-level name and value used to pass configuration, endpoints, and connection information to an application.
- GuideLanguages: C#, JavaScript, Python
Environment variables
Learn how Aspire generates environment variable names for connection strings, endpoints, service discovery, and resource properties.
- GuideLanguages: C#, TypeScript
Environments
Use Aspire environments to configure your application for development, staging, and production — parameters, secrets, container tags, and per-environment overrides.
- GuideLanguages: C#, TypeScript
Example app lifecycle workflow
Follow a worked example that uses GitHub Actions to publish Aspire artifacts and Docker Compose to deploy — a complete deployment lifecycle from commit to production.
- GuideLanguages: C#
Examples
Explore complete, runnable examples that demonstrate Aspire's resource model — custom container resources, connection strings, health checks, and event subscriptions.
- Glossary
Existing resource pattern
Connects an application to a dependency that already exists instead of creating and managing a new instance.
- Guide
Explore the Aspire dashboard with the Starter app
Explore Aspire dashboard features — resource graph, console logs, traces, metrics, and the GenAI visualizer — using the Aspire Starter app as a guided tour.
- GuideLanguages: C#, TypeScript
Expose services with Ingress and Gateway API
Learn how to expose your Aspire application services to external traffic using Kubernetes Ingress or Gateway API resources.
YouTubeExtending and Customizing Aspire
David Fowler and Damian Edwards show how to build custom integrations and resource types.
- GuideLanguages: C#, Go, Python, TypeScript
External parameters
Express secrets, connection strings, and configuration as Aspire external parameters that flow into resources at run, publish, and deploy time across environments.
- IntegrationLanguages: C#, TypeScript
Floci integration
Learn how to use the Aspire Floci hosting integration to emulate AWS, Azure, and GCP services locally in your development environment.
BlogFree Your Terminal with Detached Mode in Aspire 13.2
Aspire 13.2 brings detached mode to the CLI. Run your AppHost in the background, free your terminal, and let coding agents start, inspect, and manage your app without blocking.
- Guide
Frequently asked questions (FAQ)
Answers to common questions about Aspire — the AppHost, dashboard, integrations, TypeScript support, deployment targets, telemetry, and licensing for production apps.
- Integration
Get started with Azure AI Search integrations
Learn how the Aspire Azure AI Search integrations provision an Azure AI Search resource and wire the .NET client for vector and full-text search.
- Integration
Get started with Azure App Configuration integrations
Understand why you use the Aspire Azure App Configuration integrations and how they fit together in your Aspire AppHost.
- Integration
Get started with Blazor hosting
Learn what the Aspire Blazor hosting integration is, why to use it, and how to model and connect Blazor WebAssembly apps in your AppHost.
- Integration
Get started with Dapr and Aspire
Learn how Aspire models Dapr sidecars and components, then connects C#, TypeScript, Python, and Go apps through Dapr SDKs.
- Integration
Get started with Data API Builder
Learn how Aspire hosts Data API Builder, connects it to databases, and exposes REST or GraphQL APIs to C#, TypeScript, Python, and Go.
- QuickstartLanguages: C#, TypeScript
Get started with Deno and Aspire
Run Deno applications with Aspire, model them as AppHost resources, and configure their local development environment.
- Integration
Get started with GO Feature Flag integrations
Learn how Aspire hosts a GO Feature Flag relay proxy and connects C#, TypeScript, Python, and Go apps through OpenFeature providers.
- Integration
Get started with LavinMQ and Aspire
Learn how Aspire hosts LavinMQ and connects C#, TypeScript, Python, and Go apps with RabbitMQ-compatible AMQP 0-9-1 clients.
- Integration
Get started with Redis distributed caching
Understand why you use the Aspire Redis distributed caching integration and how it fits together in your Aspire AppHost.
- Integration
Get started with Redis output caching
Understand why you use the Aspire Redis output caching integration and how it fits together in your Aspire AppHost.
- QuickstartLanguages: C#, TypeScript
Get started with SQL Database Projects
Learn how Aspire deploys a SQL Database Project DACPAC to a SQL Server database during local development and testing.
- IntegrationLanguages: C#
Get started with the .NET / C# app integration
Understand how the Aspire Dotnet hosting integration runs C# projects and file-based apps by path from your AppHost and how to choose the right setup path.
- Integration
Get started with the Apache Kafka integrations
Learn how the Aspire Apache Kafka integrations host a Kafka broker resource and wire the .NET producer and consumer clients into your AppHost.
- Integration
Get started with the Azure AI Foundry integrations
Understand why you use the Aspire Azure AI Foundry integrations and how they fit together in your Aspire AppHost.
- IntegrationLanguages: C#
Get started with the Azure AI Inference integrations
Understand why you use the Aspire Azure AI Inference integrations and how they fit together in your Aspire AppHost.
- Integration
Get started with the Azure App Service integration
Learn how the Aspire Azure App Service integration deploys your Aspire AppHost resources to Azure App Service using the Azure provisioning model.
- Integration
Get started with the Azure Blob Storage integrations
Understand why you use the Aspire Azure Blob Storage integrations and how they fit together in your Aspire AppHost.
- Integration
Get started with the Azure Cache for Redis integrations
Understand why you use the Aspire Azure Cache for Redis integrations and how they fit together in your Aspire AppHost.
- Integration
Get started with the Azure Cosmos DB integrations
Learn how the Aspire Azure Cosmos DB integrations provision an Azure Cosmos DB account resource and wire the .NET client into your AppHost projects.
- Integration
Get started with the Azure Event Hubs integrations
Understand why you use the Aspire Azure Event Hubs integrations and how they fit together in your Aspire AppHost.
- Integration
Get started with the Azure Functions integration
Learn how the Aspire Azure Functions integration runs an Azure Functions worker resource locally and orchestrates it alongside the rest of your AppHost.
- Integration
Get started with the Azure Key Vault integrations
Learn how the Aspire Azure Key Vault integrations provision an Azure Key Vault resource and wire the .NET secret client into your AppHost projects.
- Integration
Get started with the Azure OpenAI integrations
Learn how the Aspire Azure OpenAI integrations provision an Azure OpenAI resource and wire the .NET client to call chat and embedding models.
- Integration
Get started with the Azure Queue Storage integrations
Understand why you use the Aspire Azure Queue Storage integrations and how they fit together in your Aspire AppHost.
- Integration
Get started with the Azure Service Bus integrations
Understand why you use the Aspire Azure Service Bus integrations and how they fit together in your Aspire AppHost.
- Integration
Get started with the Azure SignalR Service integration
Understand why you use the Aspire Azure SignalR Service integration and how it fits together in your Aspire AppHost.
- Integration
Get started with the Azure SQL Database integrations
Understand why you use the Aspire Azure SQL Database integrations and how they fit together in your Aspire AppHost.
- Integration
Get started with the Azure SQL EF Core integrations
Understand why you use the Aspire Azure SQL EF Core integrations and how they fit together in your Aspire AppHost.
- Integration
Get started with the Azure Table Storage integrations
Understand why you use the Aspire Azure Table Storage integrations and how they fit together in your Aspire AppHost.
- Integration
Get started with the Azure Web PubSub integrations
Understand why you use the Aspire Azure Web PubSub integrations and how they fit together in your Aspire AppHost.
- Integration
Get started with the ClickHouse integrations
Learn how the Aspire ClickHouse integrations host a ClickHouse analytics database resource and configure the .NET client for fast OLAP queries.
- Integration
Get started with the Elasticsearch integrations
Learn how the Aspire Elasticsearch integrations provision an Elasticsearch resource and configure the .NET client for search and analytics workloads.
- Integration
Get started with the flagd integration
Use the Aspire flagd hosting integration to run a feature flag server, share its connection details, and connect with OpenFeature clients.
- Integration
Get started with the Garnet integrations
Learn how the Aspire Garnet integrations provision a Garnet cache resource and wire the StackExchange.Redis-compatible client into your AppHost.
- IntegrationLanguages: Go
Get started with the Go integration
Understand how the Aspire Go hosting integration runs Go apps from your AppHost and how to choose the right setup path.
- QuickstartLanguages: C#, JavaScript, TypeScript
Get started with the Grafana k6 integration
Model Grafana k6 load tests as Aspire resources, run scripts in containers, and inspect their health, logs, and endpoints.
- QuickstartLanguages: Java
Get started with the Java integration
Run Spring Boot, Quarkus, and other Java apps from your Aspire AppHost with Maven or Gradle builds, OpenTelemetry, debugging, and generated Dockerfiles.
- Integration
Get started with the KurrentDB integrations
Learn how the Aspire KurrentDB integrations host a KurrentDB event store resource and connect the .NET client to your Aspire AppHost projects.
- Integration
Get started with the Mailpit integrations
Learn how the Aspire Mailpit integrations run a Mailpit SMTP test server resource locally so your AppHost can capture and inspect outgoing email.
- Integration
Get started with the Meilisearch integrations
Learn how the Aspire Meilisearch integrations run a Meilisearch search engine resource and wire the typed .NET client into your AppHost projects.
- Integration
Get started with the Milvus integrations
Learn how the Aspire Milvus integrations provision a Milvus vector database resource and wire your .NET client for similarity search.
- Integration
Get started with the MongoDB integrations
Learn how the Aspire MongoDB integrations provision a MongoDB container resource and configure the .NET client driver for your AppHost.
- Integration
Get started with the MySQL EF Core integration
Understand why you use the Aspire MySQL Pomelo Entity Framework Core integration and how it fits together in your Aspire AppHost.
- Integration
Get started with the MySQL integrations
Use the Aspire MySQL hosting and client integrations to spin up MySQL containers, share connections from C# and TypeScript apps, and add health checks and tracing.
- Integration
Get started with the NATS integrations
Use the Aspire NATS hosting and client integrations to spin up NATS servers locally, share credentials, and connect from C# and TypeScript apps with health checks.
- Integration
Get started with the Ollama integrations
Learn how the Aspire Ollama integrations run an Ollama LLM resource locally and wire the OllamaSharp .NET client into your AppHost projects.
- Integration
Get started with the OpenAI integrations
Learn how the Aspire OpenAI integrations register an OpenAI resource, manage your API key, and wire the .NET client into your AppHost projects.
- Integration
Get started with the Oracle EF Core integrations
Learn how the Aspire Oracle EF Core integrations host an Oracle database resource and register the Entity Framework Core DbContext for your AppHost.
- QuickstartLanguages: C#, TypeScript
Get started with the Perl hosting integration
Run Perl scripts, APIs, modules, and executables in Aspire with local dependencies, dashboard visibility, and container publishing.
- Integration
Get started with the PostgreSQL EF Core integrations
Understand why you use the Aspire PostgreSQL EF Core integrations and how they fit together in your Aspire AppHost.
- Integration
Get started with the PostgreSQL integrations
Understand how the Aspire PostgreSQL integrations fit together — model a database resource in your AppHost, then connect to it from any consuming app.
- QuickstartLanguages: C#, TypeScript
Get started with the PowerShell integration
Use the Community Toolkit PowerShell integration to run managed scripts, model dependencies, and monitor their lifecycle in Aspire.
- Integration
Get started with the Qdrant integrations
Learn how the Aspire Qdrant integrations host a Qdrant vector database resource and connect your .NET client for semantic search workloads.
- Integration
Get started with the RabbitMQ integrations
Learn how the Aspire RabbitMQ integrations provision a RabbitMQ broker resource and wire the .NET client for queues, exchanges, and consumers.
- Integration
Get started with the RavenDB integrations
Learn how the Aspire RavenDB integrations host a RavenDB document database resource and wire the .NET document store client into your app.
- Integration
Get started with the Redis integrations
Use the Aspire Redis hosting and client integrations to spin up Redis containers, share connections from C# and TypeScript apps, and add health checks and tracing.
- QuickstartLanguages: Rust
Get started with the Rust integration
Run Rust apps from your Aspire AppHost with Cargo, service discovery, OpenTelemetry, trusted development certificates, debugging, and generated Dockerfiles.
- Integration
Get started with the Seq integrations
Use the Aspire Seq hosting and client integrations to run Seq locally, ship logs from C# and TypeScript apps, and explore structured events with built-in dashboards.
- Integration
Get started with the SQL Server integrations
Learn how the Aspire SQL Server integrations provision a SQL Server container resource and configure the .NET client connection from your AppHost.
- Integration
Get started with the SQLite integrations
Learn how the Aspire SQLite integrations register a file-backed SQLite database resource and wire your .NET client with one AppHost call.
- Integration
Get started with the SurrealDB integrations
Learn how the Aspire SurrealDB integrations provision a SurrealDB multi-model database resource and wire the .NET client into your AppHost.
- Integration
Get started with the Valkey integrations
Learn how the Aspire Valkey integrations host a Valkey cache resource and configure the StackExchange.Redis-compatible client for your AppHost.
SampleLanguages: Go, TypeScriptGo API with In-Memory Storage
REST API built with Go and chi router, using in-memory storage with thread-safe operations. Opening the running app in a browser lands on a themed Scalar API reference—a polished, Go-cyan developer portal generated from the service's OpenAPI 3.1 document—while API…
- Glossary
Health check
A probe that reports whether a service or dependency is functioning, with separate roles for orchestration and application endpoints.
- GuideLanguages: C#, Go, Python, TypeScript
Health checks
Add health checks to Aspire resources to gate startup, surface readiness in the dashboard, and tie WaitFor / WaitForCompletion behavior to real application signals.
- Glossary
Heterogeneous DAG
A dependency graph containing different kinds of nodes, such as application projects, containers, cloud resources, and parameters.
- Glossary
Hoisting
In resource publishing, preserving an unresolved value for substitution at a later deployment or runtime stage.
- GuideLanguages: C#, TypeScript
Host external executables in Aspire
Host external executable applications in your Aspire AppHost using AddExecutable — model CLI tools, daemons, and language runtimes alongside containers and projects.
- Glossary
Hosting and client relationship
The division between modeling a dependency in the AppHost and connecting to that dependency inside an application.
- Glossary
Hosting integration
An Aspire integration that adds and configures resources in the AppHost application model.
- Guide
Hot Reload and watch
Learn how hot reload works in Aspire and how aspire watch rebuilds and restarts resources automatically when project files change during development.
- GuideLanguages: C#, TypeScript
How Aspire deployment works
Learn how Aspire deployment works — targets add pipeline steps, commands enter the pipeline, and components compose into a publishable artifact for any environment.
BlogHow Azure Chaos Studio ships with hermetic Aspire end-to-end tests
Learn how the Azure Chaos Studio team uses Aspire.Hosting.Testing to run hermetic, per-PR end-to-end tests across four services — with emulators, stubs, and no shared environments.
SampleLanguages: C#Image Gallery
The app consists of two services: ImageGallery.Frontend: This is a Blazor app that displays a for uploading of images, showing thumbnails of images in a grid. ImageGallery.Functions: This is an Azure Function triggered by the arrival of a new blob using a Functions Blob Trigge…
SampleLanguages: C#, TypeScriptImage Gallery with Event-Triggered Azure Container Apps Jobs
Lumina media library, light theme Lumina media library, dark theme Upload images to Azure Blob Storage with queue-triggered thumbnail generation. Demonstrates event-driven Container Apps Jobs with queue-based autoscaling, managed identity authentication, and Azure SQL free ti…
- GuideLanguages: C#, TypeScript
Inner-loop networking overview
Learn how Aspire handles inner-loop networking, endpoints, and service discovery — and how to consume them from your app code and integrations during development.
- Guide
Install Aspire CLI
Install the Aspire CLI with package managers or install scripts, then verify your setup with aspire --version before building distributed apps.
- GuideLanguages: C#, TypeScript
Install external Helm charts
Learn how to install external Helm charts alongside your Aspire application during Kubernetes deployment using AddHelmChart.
- CLI reference
Install script
Learn about the aspire-install scripts to install the Aspire CLI. Use the Aspire CLI to create, run, and manage Aspire solutions.
SampleLanguages: C#, JavaScript, PythonIntegrating a FastAPI (Python) app within an Aspire application
This sample demonstrates integrating a FastAPI (Python) app and a JavaScript frontend using Aspire. The sample consists of two apps: app: This is a simple FastAPI-based Python app that returns randomly generated weather forecast data. frontend: This is a Vite-based React app…
SampleLanguages: C#, JavaScript, TypeScriptIntegrating Angular, React, and Vue with Aspire
This sample demonstrates using the Aspire JavaScript hosting integration to configure and run client-side applications. The app consists of five services: AspireJavaScript.MinimalApi: This is an HTTP API that returns randomly generated weather forecast data. AspireJavaScript.…
- Integration
Integrations gallery
Explore the Aspire gallery of integrations and extensions to enhance your Aspire solution.
- GuideLanguages: C#, TypeScript
Interaction service
Use the Aspire interaction service to prompt users for input, request confirmation, and display messages from AppHost extensions, integrations, and custom resources.
- Glossary
IResourceAnnotation
The .NET interface for typed metadata attached to an Aspire resource to describe configuration or behavior.
- IntegrationLanguages: C#, TypeScript
JavaScript monorepo hosting extensions
Add Nx and Turborepo workspaces to Aspire with Community Toolkit decorators for package managers, child apps, and mapped ports.
- IntegrationLanguages: C#, TypeScript
k3s integration
Learn how to run a k3s Kubernetes cluster as part of your Aspire AppHost using the CommunityToolkit.Aspire.Hosting.K3s hosting integration.
- IntegrationLanguages: C#, TypeScript
Keycloak integration
Learn how to use the Keycloak integration, which includes both hosting and client integrations.
- IntegrationLanguages: C#, TypeScript
Kubernetes integration
Learn how to add Kubernetes deployment support to your Aspire application using the Aspire.Hosting.Kubernetes hosting integration.
- Guide
Languages & runtimes
Learn how Aspire works across AppHost languages, app languages, and runtime ecosystems — and find the right starting point for C#, TypeScript, Python, Java, and more.
- Guide
Legacy deployment manifest format
Learn when the legacy Aspire deployment manifest still matters and why most deployments should treat it as an intermediate artifact for tooling and migration support.
- Glossary
Lifecycle events
Signals emitted at application or resource lifecycle stages so handlers can participate in orchestration.
- IntegrationLanguages: C#, TypeScript
Local Azure provisioning
Learn how to automatically provision Azure resources during local development with Aspire in your Aspire AppHost.
- SampleLanguages: C#, JavaScript, TypeScript
MailDev and MailKit custom integrations
This sample demonstrates how to build custom Aspire hosting and client integrations with Aspire 13.6. The runnable AppHost is written in TypeScript and consumes the C# hosting integration through the Aspire Type System (ATS).
- IntegrationLanguages: C#, TypeScript
Manage Azure role assignments
Learn how to configure Azure role-based access control (RBAC) for Aspire AppHost projects so resources get the minimum permissions they need.
- GuideLanguages: C#
Manage the AppHost in tests
Manage the Aspire AppHost lifecycle in your tests — start, dispose, and configure DistributedApplicationTestingBuilder for fast, repeatable integration runs.
- CLI reference
Microsoft-collected CLI telemetry
Learn what telemetry the Aspire CLI collects, how the data is used to improve the product, and how to opt out using environment variables or CLI configuration.
- Guide
Microsoft-collected dashboard telemetry
Learn what telemetry the Aspire dashboard sends to Microsoft, how the data is used to improve the product, and how to opt out in standalone and AppHost deployments.
- Integration
Migrate Aspire apps from GitHub Models
Learn how to migrate Aspire apps from the discontinued GitHub Models integration to Microsoft Foundry for continued AI model access.
- GuideLanguages: C#, TypeScript
Migrate from Docker Compose to Aspire
Compare Aspire and Docker Compose for local development, service discovery, and observability. Map Compose services and dependencies to TypeScript or C# AppHosts.
BlogMigrating from Microsoft Learn to aspire.dev
Learn how we migrated all Aspire docs from Learn to the new website aspire.dev learn
- IntegrationLanguages: C#
MongoDB EF Core client integration
Learn how to use the MongoDB EF Core client integration to interact with MongoDB instances in your Aspire AppHost.
- Integration
MongoDB EF Core integrations overview
Use the Aspire MongoDB Entity Framework Core integrations to host a Mongo container, share a connection string, and bind a C# DbContext with health checks and tracing.
- Guide
Multi-language architecture
Understand how Aspire uses a guest/host architecture, ATS, SDK generation, and local token-based auth to support TypeScript AppHosts.
- GuideLanguages: C#, Go, TypeScript
Multi-language integrations
Annotate Aspire hosting integrations so they work with TypeScript AppHosts and the generated SDK, while preparing exports for future AppHost languages.
BlogNew Aspire database integrations
Aspire 13.2 brings MongoDB Entity Framework Core and Azure Data Lake Storage integrations, plus quality-of-life improvements to existing database clients.
SampleLanguages: JavaScript, TypeScriptNode.js Express + Redis + Vite Frontend
Visit counter with Express backend, Redis caching, and React TypeScript frontend using YARP.
- TutorialLanguages: JavaScript
Node.js OpenTelemetry with the Aspire dashboard
View JavaScript and Node.js telemetry in a local Aspire dashboard. Instrument an Express app and export OpenTelemetry traces and metrics over OTLP.
SampleLanguages: JavaScript, TypeScriptNode.js weather explorer with Aspire
An interactive weather map backed by an Express + OpenTelemetry API that reads live data from the Open-Meteo external service, all orchestrated by a TypeScript AppHost (apphost.mts). The sample consists of two apps: api: A TypeScript Express API run directly with tsx. It retu…
- Glossary
OpenTelemetry
A standard and ecosystem for collecting and exporting logs, traces, and metrics from instrumented applications.
- Guide
OpenTelemetry and distributed tracing in Aspire
Correlate application logs, distributed traces, and metrics across local services. Learn how Aspire receives OpenTelemetry and makes it available to coding agents.
- Glossary
OpenTelemetry Protocol
The protocol used to transmit telemetry such as logs, traces, and metrics from instrumented apps to a receiver.
- IntegrationLanguages: C#, TypeScript
Orleans integration
Learn how to use the Aspire Orleans Hosting integration to orchestrate and configure an Orleans cluster in your Aspire solution.
- Glossary
Parameter
A resource representing an external configuration value, such as a secret or setting that varies between environments.
- GuideLanguages: C#, TypeScript
Persist Aspire data with volumes and binds
Configure Aspire resources to persist data across restarts using container volumes and bind mounts for databases, caches, message brokers, and stateful integrations.
SampleLanguages: C#Persistent Volume
This sample demonstrates how to configure a SQL Server container to use a persistent volume in Aspire, so that the data is persisted across app launches. This method can be used to persist data across instances of other container types configured in Aspire apps too, e.g. Postg…
- GuideLanguages: C#, TypeScript
Persistent volumes on Kubernetes
Model durable storage as first-class persistent volume resources in your Aspire AppHost, then bind them to Kubernetes workloads with a storage class, capacity, and access modes.
BlogPipe dreams to pipeline realities: an Aspire Pipelines story
A deep dive into the evolution of Aspire Pipelines from basic callbacks in version 9.4 to the sophisticated pipeline execution model in Aspire 13, covering deployment orchestration, concurrency, and state management.
- GuideLanguages: C#, TypeScript
Pipelines and app topology
Learn how Aspire's unified app topology works across development and production environments — pipelines, targets, and the resource graph that drives every deployment.
- Glossary
Polyglot
Describes an application or toolchain that uses multiple programming languages, with Aspire coordinating its resources.
SampleLanguages: JavaScript, Python, TypeScriptPolyglot Task Queue
Distributed task processing with Python, C#, and Node.js workers using RabbitMQ and end-to-end OpenTelemetry tracing.
- Guide
Prerequisites
Install the prerequisites for Aspire development — .NET SDK, container runtime, IDE extensions, and the Aspire CLI, with platform-specific guidance for every target.
- IntegrationLanguages: C#, TypeScript
Project resources
Learn how to add .NET projects as resources in your Aspire AppHost — with examples for both AppHost.cs (C#) and apphost.mts (TypeScript).
- Glossary
Publish mode
The AppHost execution mode that produces deployment artifacts from the application model using configured deployment integrations.
- Glossary
Publisher
A component that interprets the application model and emits deployment artifacts for a particular target or format.
SampleLanguages: C#, Python, TypeScriptPython FastAPI + PostgreSQL Sample
FastAPI REST API with PostgreSQL database using Aspire Python support. This sample demonstrates Aspire 13's polyglot platform support for Python applications, showcasing a simple CRUD API built with FastAPI and PostgreSQL. It also ships a bespoke, on-brand Scalar API referen…
- IntegrationLanguages: C#, Python, TypeScript
Python integration
Add Python apps, modules, and ASGI services to an Aspire AppHost and orchestrate them alongside your other resources with full service discovery, environment injection, and debugging support.
BlogPython is First Class in Aspire 13
Aspire 13 introduces first-class Python support with dedicated APIs for hosting Python applications, modules, and ASGI web apps alongside your .NET services.
SampleLanguages: Python, TypeScriptPython OpenAI Agent Sample
[!NOTE] The screenshots above show a deterministic, stubbed conversation captured for documentation. Live OpenAI responses require your own API key (see below) and were not exercised when these images were generated. Python FastAPI AI agent with OpenAI integration demonstrati…
- TutorialLanguages: Python
Python OpenTelemetry with the Aspire dashboard
Send Python FastAPI logs, traces, and metrics to a local Aspire dashboard. Configure OpenTelemetry and OTLP exporters without running an AppHost.
- SampleLanguages: Python, TypeScript
Python Script Sample
Simple Python script demonstrating Aspire's Python integration with automatic virtual environment management. This sample shows how Aspire 13's Python support automatically manages Python applications, including virtual environment creation and dependency installation.
SampleLanguages: Python, TypeScriptRAG Document Q&A with Svelte
The uploaded document list, answer, and cited passages shown above are illustrative — an OpenAI API key is required for live embeddings and answers. The empty-document and upload error states are captured against the real backend. Upload documents and ask questions using Retr…
- Glossary
ReferenceExpression
A structured expression that combines text and resource value references without resolving those references too early.
- Glossary
Resource
A building block in the Aspire application model, such as a service, container, executable, cloud resource, or parameter.
- GuideLanguages: C#
Resource annotations
Learn how Aspire annotations work, how the AppHost composes built-in annotations, and how to create custom annotations to extend the resource model in your apps.
- GuideLanguages: C#, TypeScript
Resource API Patterns
Discover common API resource patterns in Aspire, including how to add and configure resources, use annotations, and compose hosting and client integrations.
- Glossary
Resource command
A named operation attached to a resource that lets a developer trigger work such as clearing a cache or seeding data.
- GuideLanguages: C#, TypeScript
Resource Hierarchies
Model parent-child resource relationships in Aspire to express ownership, lifecycle containment, and dashboard grouping for distributed application topologies.
- Glossary
Resource lifetime
The policy that determines when Aspire starts, retains, or disposes of a container, executable, or project resource.
- GuideLanguages: C#, TypeScript
Resource MCP servers
Expose MCP tools from Aspire resources and interact with them using the Aspire CLI — connect AI coding agents to databases, caches, and custom application surfaces.
- GuideLanguages: C#
Resource Model
Learn how Aspire's resource model represents distributed apps as a directed acyclic graph of services, containers, executables, and integrations in the AppHost.
- GuideLanguages: C#
Resource Publishing
Learn how Aspire publishes resource manifests as JSON for deployment tooling, including manifest annotations, value providers, and structured field expressions.
- Glossary
ResourceNotificationService
An AppHost service that publishes resource state snapshots for observers such as the dashboard and orchestration.
- Diagnostic
Retired compiler warning ASPIREATS001
ASPIREATS001 was removed in Aspire 13.4 when TypeScript AppHosts became generally available. Learn what to do if you still see this warning.
- Glossary
Run mode
The AppHost execution mode used to orchestrate an application's resources during local development.
BlogRunning Multiple Instances of an Aspire AppHost Without Port Conflicts
Aspire 13.2 introduces isolated mode, letting you run multiple instances of the same AppHost in parallel without port conflicts. Learn how the –isolated flag solves development and testing workflows.
- Reference
Samples
Explore Aspire sample projects — fully functional apps demonstrating real-world patterns, integrations, and best practices.
BlogScaling AI Agents with Aspire: The Missing Isolation Layer for Parallel Development
Scaling AI agent development with Aspire and Git worktrees by solving port conflicts through automatic port allocation scripts and an MCP proxy layer that enables parallel AI agents to orchestrate and debug complete distributed systems simultaneously.
- CLI reference
Search and filter telemetry data in the Aspire CLI
Learn how to use the --search option to filter logs, traces, and spans in the Aspire CLI.
- TutorialLanguages: C#, TypeScript
Secure communication between integrations
Learn how to secure communication between Aspire hosting and client integrations with HTTPS, mutual TLS, secret-backed parameters, and managed identities in production.
BlogSecuring Aspire Apps with Microsoft Entra ID
Learn to secure Aspire distributed applications with Microsoft Entra ID authentication. Use AI skills with GitHub Copilot for a 5-minute setup, or follow the detailed guide to understand JWT Bearer protection, OIDC sign-in, and automatic token handling.
BlogSecuring Azure apps with Aspire enterprise networking
Network security has a funny way of showing up late. You start with a web app, an API, storage, and Key Vault. The app works. The demo works. Everyone is happy. Then the production checklist shows up: Can storage and secrets be taken off the public internet? Can this app run i…
- IntegrationLanguages: C#
Seed data in a database using Aspire
Learn how to seed database data in Aspire projects using SQL scripts or Entity Framework Core during app startup.
- Glossary
Service defaults
Shared .NET application setup for telemetry, health checks, service discovery, and HTTP resilience that you explicitly opt into.
- GuideLanguages: C#, Go, Python, TypeScript
Service discovery
Understand essential Aspire service discovery concepts — endpoints, URIs, HttpClient resolution, and how service references flow from the AppHost into your app code.
- Glossary
Service discovery
Resolves logical service names to configured endpoints so clients do not need hard-coded network addresses.
- IntegrationLanguages: C#, TypeScript
Set up .NET / C# apps in the AppHost
Learn how to use the Aspire Dotnet hosting integration to add C# projects and file-based C# apps by path in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Apache Kafka in the AppHost
Learn how to use the Aspire Apache Kafka Hosting integration to orchestrate and configure a Kafka resource in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Azure AI Foundry in the AppHost
Learn how to use the Aspire Azure AI Foundry hosting integration to orchestrate and configure Foundry resources in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Azure AI Inference in the AppHost
Register an existing Azure AI Inference endpoint in your AppHost as a named connection string that any consuming app can reference.
- IntegrationLanguages: C#, TypeScript
Set up Azure AI Search in the AppHost
Learn how to use the Aspire Azure AI Search Hosting integration to orchestrate and configure an Azure AI Search resource in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Azure App Configuration in the AppHost
Learn how to use the Aspire Azure App Configuration Hosting integration to orchestrate and configure an App Configuration store in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Azure App Service in the AppHost
Learn how to use the Aspire Azure App Service Hosting integration to provision an App Service environment and deploy compute resources from your AppHost.
- IntegrationLanguages: C#, TypeScript
Set up Azure Blob Storage in the AppHost
Learn how to use the Aspire Azure Blob Storage Hosting integration to orchestrate and configure Azure Storage and blob resources in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Azure Cache for Redis in the AppHost
Learn how to use the Aspire Azure Cache for Redis Hosting integration to orchestrate and configure a managed Redis cache in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Azure Container Registry in the AppHost
Learn how to use the Aspire Azure Container Registry Hosting integration to provision, configure, and manage an Azure Container Registry resource in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Azure Cosmos DB in the AppHost
Learn how to use the Aspire Azure Cosmos DB hosting integration to orchestrate and configure a Cosmos DB account, databases, and containers in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Azure Cosmos DB in the AppHost (EF Core)
Learn how to use the Aspire Azure Cosmos DB Hosting integration to orchestrate and configure a Cosmos DB account for EF Core consuming apps in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Azure Data Explorer in the AppHost
Learn how to use the Aspire Azure Data Explorer (Kusto) hosting integration to orchestrate and configure Kusto clusters and databases in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Azure Database for PostgreSQL in the AppHost
Learn how to use the Aspire Azure PostgreSQL Hosting integration to orchestrate and configure an Azure Database for PostgreSQL flexible server in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Azure Event Hubs in the AppHost
Learn how to use the Aspire Azure Event Hubs Hosting integration to orchestrate and configure an Event Hubs namespace in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Azure Functions in the AppHost
Learn how to use the Aspire Azure Functions Hosting integration to orchestrate and configure an Azure Functions project resource in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Azure Key Vault in the AppHost
Learn how to use the Aspire Azure Key Vault Hosting integration to orchestrate and configure an Azure Key Vault resource in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Azure OpenAI in the AppHost
Learn how to use the Aspire Azure OpenAI hosting integration to provision and configure Azure OpenAI resources in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Azure Queue Storage in the AppHost
Learn how to use the Aspire Azure Queue Storage Hosting integration to orchestrate and configure an Azure Queue Storage resource in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Azure Service Bus in the AppHost
Learn how to use the Aspire Azure Service Bus Hosting integration to orchestrate and configure an Azure Service Bus namespace in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Azure SignalR Service in the AppHost
Learn how to use the Aspire Azure SignalR Service hosting integration to orchestrate and configure an Azure SignalR Service resource in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Azure SQL Database in the AppHost
Learn how to use the Aspire Azure SQL Database hosting integration to orchestrate and configure an Azure SQL Database resource in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Azure SQL in the AppHost (EF Core)
Learn how to use the Aspire Azure SQL Hosting integration to orchestrate and configure Azure SQL server and database resources in your Aspire AppHost project.
- IntegrationLanguages: C#, TypeScript
Set up Azure Table Storage in the AppHost
Learn how to use the Aspire Azure Table Storage hosting integration to orchestrate and configure Azure Table Storage in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Azure Web PubSub in the AppHost
Learn how to use the Aspire Azure Web PubSub hosting integration to orchestrate and configure an Azure Web PubSub resource in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Blazor hosting in the AppHost
Learn how to use the Aspire Blazor hosting integration APIs to model Blazor WebAssembly projects and a Blazor Gateway in your AppHost.
- IntegrationLanguages: C#
Set up ClickHouse in the AppHost
Learn how to use the Aspire ClickHouse Hosting integration to orchestrate and configure a ClickHouse database in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Dapr resources in the AppHost
Install the Community Toolkit Dapr hosting integration and configure sidecars, state stores, pub/sub, metadata, and Azure deployment.
- IntegrationLanguages: C#, TypeScript
Set up Data API Builder in the AppHost
Install the Data API Builder hosting integration, mount configuration files, reference databases, customize the image, and inspect health.
- IntegrationLanguages: C#, TypeScript
Set up Deno apps in the AppHost
Configure Deno script and task resources, permissions, endpoints, health checks, package installation, and publishing behavior in Aspire.
- IntegrationLanguages: C#, TypeScript
Set up Elasticsearch in the AppHost
Learn how to use the Aspire Elasticsearch Hosting integration to orchestrate and configure an Elasticsearch instance in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up flagd in the AppHost
Learn how to use the Aspire flagd hosting integration to orchestrate and configure a flagd resource in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Garnet in the AppHost
Learn how to use the Aspire Garnet Hosting integration to orchestrate and configure a Garnet resource in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up GitHub Models in the AppHost
Learn how to use the Aspire GitHub Models hosting integration to orchestrate and configure GitHub Model resources in an Aspire solution.
- IntegrationLanguages: C#, Go, TypeScript
Set up Go apps in the AppHost
Learn how to use the Aspire Go hosting integration to orchestrate and configure Go applications in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up GO Feature Flag in the AppHost
Learn how to use the Aspire GO Feature Flag Hosting integration to orchestrate and configure a GO Feature Flag relay proxy resource in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Grafana k6 in the Aspire AppHost
Configure the Community Toolkit k6 resource in Aspire, including scripts, browser testing, endpoints, health checks, and OpenTelemetry.
- IntegrationLanguages: C#, Java, TypeScript
Set up Java apps in the AppHost
Learn how to use the Aspire Java hosting integration to model Spring Boot, Quarkus, and other Java apps, prebuilt JARs, and container images in your AppHost.
- IntegrationLanguages: C#, JavaScript, TypeScript
Set up JavaScript apps in the AppHost
Learn how to use the Aspire JavaScript hosting integration to orchestrate and configure JavaScript and TypeScript applications in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up KurrentDB in the AppHost
Learn how to use the Aspire KurrentDB Hosting integration to orchestrate and configure a KurrentDB resource in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up LavinMQ in the Aspire AppHost
Install the Community Toolkit LavinMQ hosting integration, configure broker ports, persist data, and open the management endpoint.
- IntegrationLanguages: C#, TypeScript
Set up Mailpit in the AppHost
Learn how to use the Aspire Mailpit Hosting integration to orchestrate and configure a Mailpit resource in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Meilisearch in the AppHost
Learn how to use the Aspire Meilisearch Hosting integration to orchestrate and configure a Meilisearch resource in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Milvus in the AppHost
Learn how to use the Aspire Milvus Hosting integration to orchestrate and configure Milvus vector databases in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up MongoDB in the AppHost
Learn how to use the Aspire MongoDB Hosting integration to orchestrate and configure a MongoDB database in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up MySQL in the AppHost
Learn how to use the Aspire MySQL Hosting integration to orchestrate and configure a MySQL database in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up NATS in the AppHost
Learn how to use the Aspire NATS Hosting integration to orchestrate and configure a NATS resource in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Ollama in the AppHost
Learn how to use the Aspire Ollama hosting integration to orchestrate and configure Ollama models in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up OpenAI in the AppHost
Learn how to use the Aspire OpenAI hosting integration to orchestrate and configure OpenAI resources in an Aspire solution.
- IntegrationLanguages: C#
Set up Oracle in the AppHost
Learn how to use the Aspire Oracle Hosting integration to orchestrate and configure an Oracle database in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Perl apps in the Aspire AppHost
Configure Perl application resources in Aspire, including entrypoints, package managers, local libraries, endpoints, environment, and publishing.
- IntegrationLanguages: C#, TypeScript
Set up PostgreSQL in the AppHost
Learn how to use the Aspire PostgreSQL Hosting integration to orchestrate and configure a PostgreSQL database in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Qdrant in the AppHost
Learn how to use the Aspire Qdrant Hosting integration to orchestrate and configure a Qdrant vector database in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up RabbitMQ in the AppHost
Learn how to use the Aspire RabbitMQ Hosting integration to orchestrate and configure a RabbitMQ resource in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up RavenDB in the AppHost
Learn how to use the Aspire RavenDB Hosting integration to orchestrate and configure a RavenDB database in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Redis distributed caching in the AppHost
Learn how to add a Redis resource to your AppHost for use with the Redis distributed caching client integration.
- IntegrationLanguages: C#, TypeScript
Set up Redis in the AppHost
Learn how to use the Aspire Redis Hosting integration to orchestrate and configure a Redis resource in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Redis output caching in the AppHost
Learn how to install the Aspire Redis hosting integration and declare a Redis resource in your AppHost for use with ASP.NET Core output caching.
- IntegrationLanguages: C#, Rust, TypeScript
Set up Rust apps in the AppHost
Learn how to use the Aspire Rust hosting integration to run Cargo apps in your AppHost, configure Cargo options, debug Rust apps, and publish them as container images.
- IntegrationLanguages: C#, TypeScript
Set up Seq in the AppHost
Learn how to use the Aspire Seq hosting integration to orchestrate and configure a Seq resource in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up SQL Server in the AppHost
Learn how to use the Aspire SQL Server Hosting integration to orchestrate and configure a SQL Server database in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up SQLite in the AppHost
Learn how to use the Aspire SQLite Hosting integration to orchestrate and configure a SQLite database resource in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up SurrealDB in the AppHost
Learn how to use the Aspire SurrealDB Hosting integration to orchestrate and configure a SurrealDB resource in an Aspire solution.
- IntegrationLanguages: C#, TypeScript
Set up Valkey in the AppHost
Learn how to use the Aspire Valkey Hosting integration to orchestrate and configure a Valkey resource in an Aspire solution.
SampleLanguages: Java, JavaScript, TypeScriptSpring Petclinic with Angular, Spring Boot, and PostgreSQL
A compact Petclinic-style application demonstrating the official Aspire Java hosting integration from a TypeScript AppHost.
- Integration
SQL Server EF Core integrations overview
Use the Aspire SQL Server Entity Framework Core hosting and client integrations to provision SQL Server, share a connection, and wire up your C# DbContext seamlessly.
- Guide
Standalone Aspire dashboard for OpenTelemetry
Run a local OpenTelemetry viewer without an AppHost. Send OTLP logs, traces, and metrics from Python, Node.js, or another instrumented app to the Aspire dashboard.
SampleLanguages: C#Standalone Aspire dashboard sample app
View telemetry from any app in the Aspire dashboard. The dashboard supports running standalone, and apps configured with an OpenTelemetry SDK can send it data. This sample is a .NET console app that downloads data from NuGet. The app sends telemetry to the Aspire dashboard wh…
YouTubeTaking .NET out of Aspire
Learn how to orchestrate Python and Node.js apps with Aspire.
YouTubeTaming Service Dependencies with Aspire
Simplify managing databases, message queues, and APIs with Aspire for local development.
- GuideLanguages: C#
Telemetry after deployment
Understand how telemetry and the Aspire dashboard work after you deploy your app, and how to configure production-grade observability.
- GuideLanguages: C#, TypeScript
Test TUI and shell apps using WithTerminal
Configure interactive resource terminals with WithTerminal, choose initial dimensions, and attach from the Aspire dashboard, CLI, or VS Code.
- GuideLanguages: C#
Testing in CI/CD pipelines
Run Aspire integration tests reliably in CI/CD — GitHub Actions, Azure DevOps, container runtimes, port allocation, and managing flaky distributed application tests.
- GuideLanguages: C#
Testing overview
Write integration tests for your Aspire applications using the Aspire.Hosting.Testing package — spin up the AppHost, resolve resources, and verify end-to-end behavior.
- Guide
Translation guide for aspire.dev
Learn how to translate aspire.dev pages: set up your locale, run Lunaria locally, follow the style guide, and open localization pull requests for the Aspire docs.
- Guide
Troubleshoot the Aspire dashboard
Diagnose and resolve common Aspire dashboard issues including connection errors between the dashboard and the AppHost resource service.
BlogTypeScript AppHost in Aspire 13.2: same app model, different syntax
Aspire 13.2 enables TypeScript developers to define AppHosts directly in TypeScript, with the same streamlined Aspire application model.
- GuideLanguages: TypeScript
TypeScript AppHost project structure
Learn the files and configuration that make up a TypeScript AppHost project — entry point, package manifest, dependencies, and how the AppHost runs Aspire resources.
- Guide
Understanding resources
Learn about Aspire's resource model and how to work with different types of resources — projects, containers, executables, integrations, parameters, and connections.
- Guide
Upgrade Aspire to the latest version
Learn how to upgrade an existing Aspire app: update the Aspire CLI, run aspire update, refresh NuGet packages, and review breaking changes for each release.
- Guide
Use AI coding agents with Aspire observability
Set up Aspire skills so coding agents can inspect application logs, traces, and resource health, diagnose local failures, and verify fixes with runtime evidence.
- Quickstart
Use Aspire with GitHub Codespaces
Use Aspire in GitHub Codespaces to build multi-language apps with a preconfigured Dev Container, automatic port forwarding, and dashboard links.
- IntegrationLanguages: C#, TypeScript
Use Azure Container Registry at deploy time
Learn how Azure Container Registry is consumed as a publish target during deployment, including registry outputs and integration with your deployment pipeline.
- IntegrationLanguages: C#, TypeScript
Use community extensions for MongoDB hosting
Decorate official Aspire MongoDB resources with Community Toolkit DbGate and dbx management interfaces for local development.
- IntegrationLanguages: C#, TypeScript
Use community extensions for MySQL hosting
Decorate official Aspire MySQL resources with Community Toolkit Adminer, DbGate, and dbx management interfaces.
- IntegrationLanguages: C#, TypeScript
Use community extensions for PostgreSQL hosting
Decorate official Aspire PostgreSQL resources with Community Toolkit management interfaces and Flyway migration commands.
- IntegrationLanguages: C#, TypeScript
Use community extensions for Redis hosting
Extend the functionality of your Redis hosting with community-built extensions, including management UIs like DbGate.
- IntegrationLanguages: C#, TypeScript
Use community extensions for SQL Server hosting
Decorate official Aspire SQL Server resources with Community Toolkit Adminer, DbGate, and dbx management interfaces.
- GuideLanguages: C#, TypeScript
Use existing azd workflows
Learn the Aspire-specific compatibility details that still matter when you keep an existing Azure Developer CLI (azd) workflow — manifest handoff, hooks, and parameters.
- GuideLanguages: C#, TypeScript
Use interactive terminals in the dashboard
Use resource terminals and built-in database REPLs in the Aspire dashboard, work with the terminal dock, and manage terminal sessions.
- IntegrationLanguages: C#, TypeScript
User-assigned managed identity
Learn how to configure user-assigned managed identities for Aspire AppHost resources so deployed apps authenticate to Azure without secrets.
SampleLanguages: JavaScript, Python, TypeScriptVite React + FastAPI
Todo app with React frontend and Python FastAPI backend using YARP for unified routing.
- Glossary
WaitFor
Delays a resource's startup until a dependency is running and its configured health checks pass.
- Glossary
WaitForCompletion
Delays startup until a dependency exits with the expected exit code, rather than only waiting for it to run.
- Glossary
WaitForStart
Delays startup until a dependency reaches the running state, without waiting for its health checks.
- IntegrationLanguages: C#, Go, Python, TypeScript
What are Aspire integrations?
Aspire integrations overview page, showcasing how Aspire works with various tools and platforms in your Aspire AppHost.
- GuideLanguages: C#, TypeScript
What is Aspire?
Learn how Aspire helps you compose, debug, and deploy distributed apps with a code-first, agent-ready AppHost across C#, TypeScript, Python, JavaScript, and Java.
- Guide
What is the AppHost?
Learn how the Aspire AppHost defines your application's architecture — services, containers, executables, and integrations, modeled with C# or TypeScript code.
Release notesLanguages: C#, PythonWhat's new in Aspire 13
Explore Aspire 13.0: multi-language app development with first-class Python and JavaScript support, container-based builds, aspire do pipelines, and VS Code extension.
Release notesLanguages: C#What's new in Aspire 13.1
Explore Aspire 13.1: comprehensive MCP support for AI coding agents, CLI channel persistence, dashboard improvements, Azure Managed Redis, and container registry updates.
Release notesLanguages: C#, TypeScriptWhat's new in Aspire 13.2
Aspire 13.2 is here with new CLI commands, TypeScript AppHost support, and new and improved integrations.
Release notesLanguages: C#, TypeScriptWhat's new in Aspire 13.3
Explore Aspire 13.3: aspire destroy, Helm-based Kubernetes deploy, browser screenshot capture, JavaScript publishing, default container tunnel, and Azure updates.
BlogWhat’s New in Aspire 13.3
Aspire 13.3 is here with the Aspireify skill, command results, browser logs, Kubernetes and AKS deployment, and more.
- Release notesLanguages: C#, TypeScript
What's new in Aspire 13.4
Explore Aspire 13.4: GA TypeScript AppHost, new Go, Blazor WebAssembly, and Bun hosting integrations, richer Kubernetes and AKS deployment APIs, AI agent readiness, process resource commands, CLI integration discovery, and dashboard updates.
Release notesLanguages: C#, TypeScriptWhat's new in Aspire 13.5
Explore Aspire 13.5 updates for interactive AppHosts, TypeScript GA, the CLI, dashboard, Visual Studio Code, and cloud deployment.
Release notesLanguages: C#, TypeScriptWhat's new in Aspire 13.6
Explore Aspire 13.6 dashboard run history, first-party Java and Rust hosting, portable volume paths, CLI workflows, deployment, and integration updates.
Release notesLanguages: C#What's new in Aspire 9.0
Explore Aspire 9.0: ANSI console log formatting, browser telemetry, waiting-for-resource health gates, persistent containers, Redis Insight, and Azure Functions support.
Release notesLanguages: C#What's new in Aspire 9.1
Explore Aspire 9.1: parent and child resource grouping, dashboard language picker, telemetry filtering, console log downloads, and resource detail enhancements.
Release notesLanguages: C#What's new in Aspire 9.2
Explore Aspire 9.2: dashboard cardinality limits, UTC console logs, telemetry pause, resource icons, and broader app-host and integrations updates across the stack.
Release notesLanguages: C#What's new in Aspire 9.3
Explore Aspire 9.3: GitHub Copilot in the dashboard, dashboard context menu, metric warnings, traces for uninstrumented resources, and dashboard filtering updates.
Release notesLanguages: C#What's new in Aspire 9.4
Explore Aspire 9.4: dashboard interaction service, hidden resources, connection-string display, tracing peers, console log wrapping, and parameter authoring updates.
Release notesLanguages: C#What's new in Aspire 9.5
Explore Aspire 9.5: combined console logs view, GenAI trace visualizer, trace details, aspire update, richer property grids, and a refreshed dashboard.
YouTubeWindows 365 Meets Aspire
Boost multi-repo microservice productivity with Aspire extensions for simplified onboarding.
- Glossary
WithAnnotation
A C# resource-builder extension method that attaches typed annotation metadata to a resource.
- Glossary
WithReference
Supplies a consuming resource with connection strings or service endpoint configuration from another resource.
SampleLanguages: C#Working with client apps in an Aspire application
This sample demonstrates working with client apps such as WinForms, WPF, etc., in an Aspire app, such that the client app is launched along with the AppHost project, can resolve services via service discovery, and logs, traces, and metrics are sent via OpenTelemetry to the das…
SampleLanguages: C#, GoWorking with container-built resources in an Aspire application
This sample demonstrates integrating applications into an Aspire app via Dockerfiles and container-based builds. This is especially helpful to integrate applications written in languages that Aspire does not have a native integration for, or to reduce the prerequisites require…
SampleLanguages: C#Working with database containers in an Aspire application
This sample demonstrates working with database containers in an Aspire app, using the features of the underlying container image to modify the default database created during container startup. This is especially helpful when not using an ORM like Entity Framework Core that ca…
- IntegrationLanguages: C#
WPF and Windows Forms with Aspire
Learn how to orchestrate WPF and Windows Forms desktop applications alongside Aspire-managed backend services during local development.
- TutorialLanguages: C#
Write your first test
Test your Aspire solutions using xUnit.net, NUnit, or MSTest — wire up DistributedApplicationTestingBuilder, start the AppHost, and assert on resources from your tests.
- SampleLanguages: C#
Writing custom resources for Aspire hosting integrations
This sample demonstrates how to write custom resources for Aspire hosting integrations. This is useful when you want to integrate something into the Aspire development experience as a resource that isn't an executable or container. Custom resources can particpate in the Aspire…
- IntegrationLanguages: C#, TypeScript
YARP integration
Learn how to use the YARP (Yet Another Reverse Proxy) integration for reverse proxy functionality.
SampleLanguages: TypeScriptYARP Serving Static Files
YARP reverse proxy serving a Vite frontend with dual-mode operation (dev HMR + production static files).
BlogYour dev loop is full of tribal knowledge
Aspire turns a team’s scattered tribal knowledge into an explicit, incrementally-adoptable app model that humans, scripts, and AI agents can all use.
Aspire