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.

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

Install the Aspire CLI

To install the Aspire CLI, download and run the installation script in a single command:

Bash

Install script (macOS/Linux)

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

PowerShell

Install script (Windows)

irm https://aspire.dev/install.ps1 | iex

The script installs the latest stable release of Aspire CLI. During installation, you might be asked Do you want to continue?. Reply with Y for Yes or A for Yes to All to continue downloading and running the install script. See Validation to verify the installation.

Tip

At any time, you can reopen the Install Aspire CLI command modal from the top navigation (download icon ). The modal shows the download-and-install command for your OS, so you can run the installer again when needed.

You only need to download the script separately if you want to inspect it or run the installer as separate commands. For more information, see the aspire-install script reference.

Validation

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

Check installed version

aspire --version

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

Aspire CLI — Output

13.2.0+{commitSHA}

The +{commitSHA} suffix indicates the specific commit from which the Aspire CLI was built.

Learn more by reading the Aspire CLI reference documentation.

Troubleshooting

If you’re not seeing a version number, it’s possible that your terminal session needs to be restarted to pick up the changes to your PATH environment variable. Simply close and reopen your terminal, then try running the aspire --version command again.

See also

• aspire-install script reference
• aspire command reference
• Aspire VS Code extension — install the CLI and use Aspire commands from within VS Code