aspire update command

Name

aspire update - Update Aspire packages and templates in your project.

Synopsis

Aspire CLI

aspire update [options]

Description

The aspire update command helps you keep your Aspire projects current by automatically detecting and updating outdated packages and templates. It finds outdated Aspire NuGet packages while respecting channel configurations and intelligently handles complex dependency graphs.

The Aspire CLI uses the following logic, in order, to determine which AppHost project to process:

• The --apphost option.

  This option specifies the path to the Aspire AppHost project file to process.

• The rooted aspire.config.json file.

  If the rooted config exists in the current directory, it’s used. If not, the CLI walks up the directory structure looking for it. If Aspire finds the rooted config, it uses the recorded AppHost information to determine which project to process. Legacy .aspire/settings.json files are still read during migration.

• Searches the current directory and subdirectories.

  Starting in the current directory, the CLI gathers all AppHost projects from that directory and below. If a single project is discovered, it’s automatically selected. If multiple projects are discovered, they’re printed to the terminal for the user to manually select one of the projects.

  Once a project is selected, either automatically or manually, Aspire records that selection in the rooted configuration so later commands can reuse it.

The command performs the following:

• Detects outdated Aspire NuGet packages in your project
• Respects your configured Aspire channel (preview, stable, etc.)
• Resolves diamond dependencies to avoid duplicate updates
• Validates package compatibility before applying changes
• Provides colorized output with detailed summary of changes

Note

The aspire update command requires an interactive terminal. The --non-interactive flag is not currently supported for this command. In CI/CD pipelines or other non-interactive environments, update Aspire packages manually using aspire add {package} or equivalent tooling.

Options

The following options are available:

• --apphost <apphost>

  The path to the Aspire AppHost project file.

• --self

  Update the Aspire CLI itself to the latest version.

• --channel

  Channel to update to (stable, staging, daily).

• -?, -h, --help

  Prints help and usage documentation for the available commands and options.

• -l, --log-level <Critical|Debug|Error|Information|None|Trace|Warning>

  Set the minimum log level for console output. Use this option to increase diagnostics while troubleshooting or reduce output in scripted runs.

• --non-interactive

  Run the command in non-interactive mode, disabling all interactive prompts and spinners.

• --nologo

  Suppress the startup banner and telemetry notice.

• --banner

  Display the animated Aspire CLI welcome banner.

• --wait-for-debugger

  Wait for a debugger to attach before running a command.

Examples

• Analyze and update out-of-date Aspire packages and templates:

  Aspire CLI

  aspire update

• Update a specific AppHost project:

  Aspire CLI

  aspire update --apphost './projects/apphost/orchestration.AppHost.csproj'