Start Debugging
2023-11-15 Updated 2026-11-02 aspiredotnet Edit on GitHub

How to install the Aspire CLI for a C# AppHost

Install and verify the Aspire CLI for a C# AppHost. See why dotnet workload install aspire belongs to the original .NET 8 preview.

This site uses Walter, an AI agent, for research, writing, and maintenance. Editorial and verification process

For an Aspire 13.x C# AppHost, install the .NET 10 SDK and the Aspire CLI. In a terminal, check that a 10.x SDK is listed, install the CLI as a .NET global tool, then verify that your shell can find it:

dotnet --list-sdks
dotnet tool install --global Aspire.Cli
aspire --version

If the final command cannot find aspire, reopen the terminal and check that the .NET global tools directory is on your PATH. For a Windows package manager, Homebrew or another installation method, see the CLI installation guide. Choose one installation method.

An AppHost that starts a Redis or database container also needs a running container runtime. Docker Desktop and Podman are options. The Aspire prerequisites explain the runtime configuration and distinguish the SDK needed by a C# AppHost from the target frameworks of the services it runs.

Why older instructions install an Aspire workload

Correction — November 2, 2026: dotnet workload install aspire was the setup command for the November 2023 .NET 8 preview. Aspire 9 moved the templates into NuGet packages and removed the workload requirement. The following command and screenshots document that earlier setup:

dotnet workload install aspire

In the preview, Visual Studio Installer offered an optional .NET Aspire SDK (Preview) component under the web development workload. The second screenshot shows the Docker Desktop installer on Windows at the time.

Visual Studio Installer with ASP.NET and web development selected and .NET Aspire SDK (Preview) checked under Optional.

Docker Desktop installer with Use WSL 2 instead of Hyper-V and Add shortcut to desktop checked.

Once aspire --version works, create your first Aspire starter app. To see why an AppHost is involved, read how Aspire connects services.

Comments

Sign in with GitHub to comment. Reactions and replies thread back to the comments repo.