Edit

Share via

aspire config set command

This article applies to: ✔️ Aspire CLI 9.4.0 and later versions

Name

aspire config set - Set a configuration value.

Synopsis

aspire config set <key> <value> [options]

Description

The aspire config set command sets a config value by key name.

Aspire supports a local and global settings file. Settings defined in a local settings file override those set in the global settings file.

  • Local settings

    A local settings file is stored at .aspire/settings.json under the current directory.

  • Global settings

    The global settings file is stored at $HOME/.aspire/globalsettings.json.

Arguments

The following arguments are available:

  • key

    The configuration key to update.

    Tip

    For available keys, see the Settings section. Look for names that start with the features prefix. Feature toggles are boolean values that enable or disable specific features in the Aspire CLI.

  • value

    The configuration value to set.

Options

The following options are available:

  • -g, --global

    Set the configuration value globally in $HOME/.aspire/globalsettings.json instead of the local settings file.

  • -?, -h, --help

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

  • -d, --debug

    Enable debug logging to the console, which prints detailed information about what Aspire CLI is doing when a command is run.

  • --wait-for-debugger

    Wait for a debugger to attach before running a command.

Available settings

The following config settings are available:

Setting Description
appHostPath The path to the AppHost project that the Aspire CLI uses by default. This setting is set by the Aspire CLI when you select a project or when Aspire is first run and detects an AppHost project.
features.execCommandEnabled Enables or disables the exec command in Aspire CLI. Set to true to allow execution features, or false to disable them.
features.minimumSdkCheckEnabled Enables or disables minimum SDK version checking in Aspire CLI. Set to true to enforce SDK version requirements, or false to disable the check.
features.orphanDetectionWithTimestampEnabled Enables or disables orphan resource detection with timestamp tracking in Aspire CLI. Set to true to enable enhanced orphan detection, or false to disable it.
features.packageSearchDiskCachingEnabled Enables or disables disk caching for package search results in Aspire CLI. Set to true to cache search results locally, or false to disable caching.
features.showDeprecatedPackages Controls whether deprecated packages are shown in search results and package listings. Set to true to show deprecated packages, or false to hide them.
features.singleFileAppHostEnabled Enables or disables support for single-file AppHost projects in Aspire CLI. Set to true to enable single-file AppHost support, or false to disable it.
features.stagingChannelEnabled Enables or disables access to staging channel packages and features in Aspire CLI. Set to true to enable staging channel access, or false to disable it.
features.updateNotificationsEnabled Enables or disables update notifications in Aspire CLI. Set to true to show notifications about available updates, or false to disable them.