From fc32cec6ca1c6a945c52eb83509f0528951f58ce Mon Sep 17 00:00:00 2001 From: "aspire-repo-bot[bot]" <268009190+aspire-repo-bot[bot]@users.noreply.github.com> Date: Tue, 10 Nov 2026 18:04:23 +0000 Subject: [PATCH] Document DnxPinned version-specific CLI bundle --- src/frontend/src/content/docs/get-started/aspire-sdk.mdx | 2 ++ 1 file changed, 2 insertions(+) diff --git a/src/frontend/src/content/docs/get-started/aspire-sdk.mdx b/src/frontend/src/content/docs/get-started/aspire-sdk.mdx index 6016fdcff9..43ca9e8560 100644 --- a/src/frontend/src/content/docs/get-started/aspire-sdk.mdx +++ b/src/frontend/src/content/docs/get-started/aspire-sdk.mdx @@ -162,6 +162,8 @@ When `AspireUseCliBundle` is `true` and you start the AppHost with `dotnet run` - **`Dnx`** — always invokes the Aspire CLI through `dnx`, using the unversioned `Aspire.Cli` package. This honors an in-scope [.NET local tool manifest](https://learn.microsoft.com/dotnet/core/tools/local-tools-how-to-use#create-a-manifest-file) (`.config/dotnet-tools.json`) if one pins `Aspire.Cli`, or resolves the latest published package when no manifest applies. - **`DnxPinned`** — always invokes the Aspire CLI through `dnx`, using `Aspire.Cli@` pinned to the exact `Aspire.Cli` version paired with `Aspire.AppHost.Sdk`. Use this when the CLI must match the AppHost SDK version exactly, ignoring any local tool manifest. + The pinned mode also uses a version-specific bundle. Unless you set `AspireCliPath` or `AspireCliBundlePath`, the SDK resolves the bundle only from `$ASPIRE_HOME/dnx/aspire.cli/` (by default under `~/.aspire`). It runs `aspire setup` into that directory when it doesn't exist yet, so a bundle left by a different global Aspire CLI version is never used and the global CLI's bundle layout isn't modified. + Set `AspireCliInvocationMode` in your AppHost `.csproj`: ```xml title="MyApp.AppHost.csproj"