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.

ノート

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. Update the Aspire CLI to the latest version:

   Update the Aspire CLI

   aspire update --self

2. Update your Aspire solution by running:

   Update your Aspire solution

   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)

For more information, see aspire update command reference.

Update the VS Code extension (optional)

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

1. Open VS Code
2. Go to Extensions ( Command + Shift + X CmdShiftX Control + Shift + X CtrlShiftX Control + Shift + X CtrlShiftX )
3. Search for Aspire
4. Click Update if an update is available

For more information, see Aspire extension for VS Code.

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!

ヒント

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:

Run the Aspire application

aspire run

Need help?

• 🆘 Stuck? Join the Discord community for real-time support
• 🐛 Found a bug? File a GitHub issue