azd up deploys Aspire Dashboard with pinned linuxFxVersion ignoring local .NET SDK version

[lim-dy]

Is there an existing issue for this?

• I have searched the existing issues

Describe the bug

When deploying a .NET 10 Aspire application using azd up, the provisioned Azure App Service for the Aspire Dashboard is pinned to an older runtime version. This results in a version discrepancy where the local dashboard runs on .NET 10 (Aspire 13.1), but the cloud instance runs on an older runtime (.NET 8).

Expected Behavior

azd should detect the targeted Aspire version from the application model or SDK context and deploy the corresponding dashboard container image (e.g., mcr.microsoft.com/dotnet/aspire-dashboard:13.0) to ensure feature parity between local and cloud environments.

Steps To Reproduce

1. Create a new Aspire project
   AppHost.cs

...
var ServiceEnv = builder.AddAzureAppServiceEnvironment("ServiceEnv")
    .WithDashboard(enable: true)
    .WithAzureContainerRegistry(sharedAcr)
    .ConfigureInfrastructure(infra =>
    {
        var env = infra.GetProvisionableResources()
            .OfType<AppServicePlan>()
            .Single();

        env.Kind = "linux";
        env.Sku = new AppServiceSkuDescription()
        {
            Name = "B2",
            Tier = "Basic"
        };
        env.IsReserved = true;
        env.IsPerSiteScaling = false;
    });
...

2. Ensure global.json is set to .NET 10.
3. Run azd init, azd infra gen and azd up.
4. Check the deployed Azure App Service configuration for the dashboard resource.

On Azure:

On Local:

Exceptions (if any)

No response

.NET Version info

.NET SDK:
Version: 10.0.100
Commit: b0f34d51fc
Workload version: 10.0.101.1
MSBuild version: 18.0.2+b0f34d51f

Runtime Environment:
OS Name: ubuntu
OS Version: 24.04
OS Platform: Linux
RID: ubuntu.24.04-x64
Base Path: /usr/lib/dotnet/sdk/10.0.100/

.NET workloads installed:
There are no installed workloads to display.
Configured to use workload sets when installing new manifests.

Host:
Version: 10.0.0
Architecture: x64
Commit: b0f34d51fc

.NET SDKs installed:
8.0.122 [/usr/lib/dotnet/sdk]
10.0.100 [/usr/lib/dotnet/sdk]

.NET runtimes installed:
Microsoft.AspNetCore.App 8.0.22 [/usr/lib/dotnet/shared/Microsoft.AspNetCore.App]
Microsoft.AspNetCore.App 10.0.0 [/usr/lib/dotnet/shared/Microsoft.AspNetCore.App]
Microsoft.NETCore.App 8.0.22 [/usr/lib/dotnet/shared/Microsoft.NETCore.App]
Microsoft.NETCore.App 10.0.0 [/usr/lib/dotnet/shared/Microsoft.NETCore.App]

Other architectures found:
None

Environment variables:
Not set

global.json file:
/home/dlim/PowerToolsWeb/global.json

Learn more:
https://aka.ms/dotnet/info

Download .NET:
https://aka.ms/dotnet/download

Anything else?

dotnet --version
10.0.100

aspire --version
13.1.0+8a4db1775c3fbae1c602022b636299cb04971fde

azd version
azd version 1.23.2 (commit 83096ae8add9cb037f8fa138510a433eb0513536)

Currently, I deployed the standalone dashboard using AddContainer in AppHost.cs but I can't only see the log.

[lim-dy]

This is the created bicep by azd infra gen:

resource dashboard 'Microsoft.Web/sites@2025-03-01' = {
  name: take('${toLower('appServiceEnv')}-${toLower('aspiredashboard')}-${uniqueString(resourceGroup().id)}', 60)
  location: location
  properties: {
    serverFarmId: appServiceEnv_asplan.id
    siteConfig: {
      numberOfWorkers: 1
      linuxFxVersion: 'ASPIREDASHBOARD|1.0'
      acrUseManagedIdentityCreds: true
      acrUserManagedIdentityID: appServiceEnv_mi.properties.clientId
      appSettings: [
        {
          name: 'Dashboard__Frontend__AuthMode'
          value: 'Unsecured'
        }
        {
          name: 'Dashboard__Otlp__AuthMode'
          value: 'Unsecured'
        }
        {
          name: 'Dashboard__Otlp__SuppressUnsecuredTelemetryMessage'
          value: 'true'
        }
        {
          name: 'Dashboard__ResourceServiceClient__AuthMode'
          value: 'Unsecured'
        }
        {
          name: 'WEBSITES_PORT'
          value: '5000'
        }
        {
          name: 'HTTP20_ONLY_PORT'
          value: '4317'
        }
        {
          name: 'WEBSITE_START_SCM_WITH_PRELOAD'
          value: 'true'
        }
        {
          name: 'AZURE_CLIENT_ID'
          value: appServiceEnv_contributor_mi.properties.clientId
        }
        {
          name: 'ALLOWED_MANAGED_IDENTITIES'
          value: appServiceEnv_mi.properties.clientId
        }
        {
          name: 'ASPIRE_ENVIRONMENT_NAME'
          value: 'appServiceEnv'
        }
      ]
      alwaysOn: true
      http20Enabled: true
      http20ProxyFlag: 1
    }
  }
  identity: {
    type: 'UserAssigned'
    userAssignedIdentities: {
      '${appServiceEnv_contributor_mi.id}': { }
    }
  }
  kind: 'app,linux,aspiredashboard'
}

[davidfowl]

What does it matter? The dashboard should be treated like infrastructure, it's not part of your application.

[lim-dy]

Hi, @davidfowl
I am just reporting the version discrepancy.
Is that intended?

[mwijnands]

I just noticed the same thing and it annoys me that I might be missing out on new features that the Aspire Dashboard v13.x might have and that it might not work correctly.

Could you give more info on how this works on the Azure side @davidfowl? Does everybody just get the same version of the dashboard in Azure? Until someone at Microsoft decides to update it? Also it would be nice that this info is somewhere in the docs of "Aspire dashboard in Azure". As I've been thinking for hours now that I missed a config settings somewhere.

[davidfowl]

Could you give more info on how this works on the Azure side @davidfowl? Does everybody just get the same version of the dashboard in Azure? Until someone at Microsoft decides to update it? Also it would be nice that this info is somewhere in the docs of "Aspire dashboard in Azure". As I've been thinking for hours now that I missed a config settings somewhere.

Yes

cc @ShilpiR