Install Aspire CLI

Aspire provides a command-line interface (CLI) tool to help you create and manage Aspire-based apps. The CLI streamlines your development workflow with an interactive-first experience. This guide shows you how to install the Aspire CLI on your system. The Aspire CLI requires the .NET 10.0 SDK.

Before installing the Aspire CLI, ensure you have the required prerequisites set up.

Install as a native executable

The Aspire CLI is installed using an installation script available for Bash and PowerShell.

You can download and run the script in a single command, to install the Aspire CLI as a native executable:

Bash
PowerShell

curl -sSL https://aspire.dev/install.sh | bash

iex "& { $(irm https://aspire.dev/install.ps1) }"

The script installs the latest stable release of Aspire CLI. See Validation to verify the installation.

Alternatively, you can download the script and run it as a two-step process:

Open a terminal.

Download the script and save it as a file:

Bash
PowerShell

curl -sSL https://aspire.dev/install.sh -o aspire-install.sh

irm https://aspire.dev/install.ps1 -OutFile aspire-install.ps1

Run the script to install the stable release build of Aspire.

You should see output similar to the following snippet:
- Bash
- PowerShell
Output
Downloading from: https://aka.ms/dotnet/9/aspire/ga/daily/aspire-cli-linux-x64.tar.gz Aspire CLI successfully installed to: /home/username/.aspire/bin/aspire Added /home/username/.aspire/bin to PATH for current session Added /home/username/.aspire/bin to PATH in /home/username/.bashrc The aspire cli is now available for use in this and new sessions.
Output
Downloading from: https://aka.ms/dotnet/9/aspire/ga/daily/aspire-cli-win-x64.zip Aspire CLI successfully installed to: C:\Users\name\.aspire\bin\aspire.exe Added C:\Users\username\.aspire\bin to PATH for current session Added C:\Users\username\.aspire\bin to user PATH environment variable The aspire cli is now available for use in this and new sessions.

Install as a .NET global tool

Use the dotnet tool command to install the Aspire CLI global tool. The name of the global tool is Aspire.Cli.

Open a terminal.
Run the following command to install Aspire CLI:
.NET CLI
```
dotnet tool install -g Aspire.Cli --prerelease
```

Validation

To validate that the global tool is installed, use the --version option to query Aspire CLI for a version number:

aspire --version

If that command works, you’re presented with the version of the Aspire CLI tool:

13.0.0+{commitSHA}

Learn more by reading the Aspire CLI reference documentation.