Upgrade Aspire

Upgrading Aspire involves updating the Aspire CLI itself, the Aspire SDK, and all related packages in your solution. The aspire update command handles most of this for you, but you may also need to review breaking changes and update tooling extensions.

Note

If you're new to Aspire, there's no reason to upgrade anything. See prerequisites and install Aspire CLI to get started.

Upgrade with the Aspire CLI

  1. 1

    Update the Aspire CLI to the latest version:

    aspire update --self
  2. 2

    Update your Aspire solution by running:

    aspire update

    This command automatically:

    • Updates the Aspire.AppHost.Sdk version
    • Updates all Aspire NuGet packages to the latest version
    • Supports both regular projects and Central Package Management (CPM)

Update the VS Code extension (optional)

If you have the Aspire extension installed, you can update it to get the latest tooling support:

  1. 1

    Open VS Code

  2. 2

    Go to Extensions ()

  3. 3

    Search for Aspire

  4. 4

    Click Update if an update is available

Remove the legacy workload (Aspire 8 only)

Still rocking the Aspire workload? No judgment here—we've all been there. 🕰️ Time to let it go and join us in the future!

Tip

This step is only needed if you're upgrading from Aspire 8. If you're already on Aspire 9 or later, you're good.

Please remove the aspire workload with the following command:

dotnet workload uninstall aspire

Verify the upgrade

After upgrading, run your application to ensure everything works as expected:

aspire run

Need help?

Previous Aspire 9.0Next Prerequisites