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.
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.