Aspire.Cli.win-x64 13.6.1
Aspire CLI
The Aspire CLI is used to create, run, and manage Aspire-based distributed applications.
Usage
aspire <command> [options]
Global Options
| Option | Description |
|---|---|
-h, /h |
Show help and usage information. |
-v, --version |
Show version information. |
-l, --log-level |
Set the minimum log level for console output (Trace, Debug, Information, Warning, Error, Critical). |
--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 executing the command. |
Commands
App Commands
| Command | Description |
|---|---|
new |
Create a new app from an Aspire starter template. |
init |
Initialize Aspire in an existing codebase. |
add [<integration>] |
Add a hosting integration to the apphost. |
update |
Update integrations in the Aspire project. |
run |
Run an apphost in development mode. |
stop |
Stop a running apphost or the specified resource. |
ps |
List running apphosts. |
Resource Management
| Command | Description |
|---|---|
start <resource> |
Start a stopped resource. |
stop [<resource>] |
Stop a running apphost or the specified resource. |
restart <resource> |
Restart a running resource. |
wait <resource> |
Wait for a resource to reach a target status. |
command <resource> <command> |
Execute a command on a resource. |
Monitoring
| Command | Description |
|---|---|
describe [<resource>] |
Describe resources in a running apphost. |
logs [<resource>] |
Display logs from resources in a running apphost. |
otel |
View OpenTelemetry data (logs, spans, traces) from a running apphost. |
Deployment
| Command | Description |
|---|---|
publish |
Generate deployment artifacts for an apphost. |
deploy |
Deploy an apphost to its deployment targets. |
destroy |
Destroy a previously deployed AppHost environment. |
do <step> |
Execute a specific pipeline step and its dependencies. |
Tools & Configuration
| Command | Description |
|---|---|
config |
Manage CLI configuration including feature flags. |
cache |
Manage disk cache for CLI operations. |
doctor |
Diagnose Aspire environment issues and verify setup. |
docs |
Browse and search Aspire documentation and API reference from aspire.dev. |
agent |
Manage AI agent specific setup. |
Examples
To initialize an empty C# AppHost without discovering incidental .sln or .slnx files, run this from the repository root:
aspire init --file-based --language csharp
This creates apphost.cs and its supporting configuration in the current directory instead of creating a solution-based AppHost project. --file-based requires C#: it reports an error before scaffolding if another language is selected explicitly, configured, or chosen at the language prompt. Omit --file-based (or pass --file-based false) to use normal non-C# scaffolding. It does not overwrite existing AppHosts or suppress agent setup.
# Create a new Aspire application
aspire new
# Run the apphost
aspire run
# Start in the background (useful for CI and agent environments)
aspire start --isolated
# Check resource status
aspire describe
# Stream resource state changes
aspire describe --follow
# View logs
aspire logs
aspire logs webapi
# Stop the apphost
aspire stop
# Wait for a resource to be healthy (CI/scripts)
aspire start
aspire wait webapi --timeout 60
# Add an integration
aspire add redis
# Diagnose environment issues
aspire doctor
# Search the API reference
aspire docs api search "RunAsEmulator" --language csharp
# Search Aspire documentation
aspire docs search "redis"
Browser certificate trust configuration
On Linux, the NSS databases used to trust the Aspire development certificate can be configured locally or in the user-level Aspire configuration:
aspire config set --global certificates.nssDbPaths "firefox=/path/to/firefox/profile:chromium=/path/to/chromium/nssdb"
Prefix a path with firefox= or chromium= to apply the trust settings expected by that browser family.
The certificates.nssDbPaths setting takes precedence over the upstream DOTNET_DEV_CERTS_NSSDB_PATHS environment variable. When the Aspire setting has no value, the CLI preserves the upstream behavior.
Additional documentation
Feedback & contributing
No packages depend on Aspire.Cli.win-x64.
| Version | Downloads | Last updated |
|---|---|---|
| 13.6.1 | 2 | 10/09/2026 |
| 13.6.0 | 3 | 10/03/2026 |
| 13.5.4 | 7 | 09/21/2026 |
| 13.5.3 | 7 | 09/26/2026 |
| 13.5.2 | 6 | 09/26/2026 |
| 13.5.1 | 5 | 09/26/2026 |
| 13.5.0 | 6 | 09/26/2026 |
| 13.4.6 | 6 | 09/26/2026 |
| 13.4.5 | 5 | 09/26/2026 |
| 13.4.4 | 6 | 09/26/2026 |
| 13.4.3 | 5 | 09/26/2026 |
| 13.4.2 | 6 | 09/26/2026 |
| 13.4.1 | 6 | 09/26/2026 |
| 13.4.0 | 5 | 09/26/2026 |
| 13.3.5 | 6 | 09/26/2026 |
| 13.3.4 | 7 | 09/26/2026 |
| 13.3.3 | 6 | 09/26/2026 |
| 13.3.2 | 6 | 09/26/2026 |
| 13.3.1 | 7 | 09/26/2026 |
| 13.3.0 | 5 | 09/26/2026 |