Skip to content
Aspire

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 the Aspire CLI

Section titled “Install the Aspire CLI”

To install the Aspire CLI download and run the install script:

Two-step installation process

Section titled “Two-step installation process”

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

  1. Open a terminal.

  2. Download the script and save it as a file:

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

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

    You should see output similar to the following snippet:

    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.

Validation

Section titled “Validation”

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

Aspire CLI
aspire --version

Consider the following example of running the command:

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

Aspire CLI — Output
13.0.0+{commitSHA}

The +{commitSHA} suffix indicates the specific commit from which the Aspire CLI was built. This suffix is included in pre-release builds and may not be present in stable releases.

Learn more by reading the Aspire CLI reference documentation.

See also

Section titled “See also”
FAQCollaborateCommunityDiscussWatch