# 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.

<LearnMore>
  Before installing the Aspire CLI, ensure you have the [required
  prerequisites](/get-started/prerequisites/) set up.
</LearnMore>

## Install the Aspire CLI

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

<Aside type="note" title="Download and install" icon="download">
You can download and run the installation script in a single command to install the Aspire CLI:

<OsAwareTabs syncKey="terminal">
  <Code
    slot="unix"
    lang="bash"
    title="Install script (macOS/Linux)"
    code="curl -sSL https://aspire.dev/install.sh | bash"
  />
  <Code
    slot="windows"
    lang="powershell"
    title="Install script (Windows)"
    code="irm https://aspire.dev/install.ps1 | iex"
  />
</OsAwareTabs>

The script installs the latest stable release of Aspire CLI. See [Validation](#validation) to verify the installation.

</Aside>

### Two-step installation process

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

1.  Open a terminal.
1.  Download the script and save it as a file:

    <OsAwareTabs syncKey="terminal">
      <Code
        slot="unix"
        lang="bash"
        title="Download script (macOS/Linux)"
        code="curl -sSL https://aspire.dev/install.sh -o aspire-install.sh"
      />
      <Code
        slot="windows"
        lang="powershell"
        title="Download script (Windows)"
        code="irm https://aspire.dev/install.ps1 -OutFile aspire-install.ps1"
      />
    </OsAwareTabs>

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

        You should see output similar to the following snippet:

    <OsAwareTabs syncKey="terminal">
      <Code
        slot="unix"
        lang="txt"
        title="Installation output (macOS/Linux)"
        frame="terminal"
        code={
          'Downloading from:\n' +
          'https://aka.ms/dotnet/9/aspire/ga/daily/aspire-cli-linux-x64.tar.gz\n' +
          'Aspire CLI successfully installed to: /home/username/.aspire/bin/aspire\n' +
          'Added /home/username/.aspire/bin to PATH for current session Added\n' +
          '/home/username/.aspire/bin to PATH in /home/username/.bashrc The aspire\n' +
          'cli is now available for use in this and new sessions.'
        }
      />
      <Code
        slot="windows"
        lang="txt"
        title="Installation output (Windows)"
        frame="terminal"
        code={
          'Downloading from: https://aka.ms/dotnet/9/aspire/ga/daily/aspire-cli-win-x64.zip\n' +
          'Aspire CLI successfully installed to:\n' +
          'C:\\Users\\name\\.aspire\\bin\\aspire.exe Added C:\\Users\\username\\.aspire\\bin\n' +
          'to PATH for current session Added C:\\Users\\username\\.aspire\\bin to user\n' +
          'PATH environment variable The aspire cli is now available for use in\n' +
          'this and new sessions.'
        }
      />
    </OsAwareTabs>

## Validation

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

```bash title="Check installed version"
aspire --version
```

Consider the following example of running the command:

<AsciinemaPlayer
  src="/casts/aspire-version.cast"
  poster="npt:0:01"
  rows="5"
  autoPlay={true}
  loop={false}
/>

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

```bash title="Aspire CLI — Output" data-disable-copy
13.2.0+{commitSHA}
```

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

<LearnMore>
  Learn more by reading the [Aspire CLI reference](/reference/cli/overview/)
  documentation.
</LearnMore>
**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](/reference/cli/install-script/)
- [`aspire` command reference](/reference/cli/commands/aspire/)
- [Aspire VS Code extension](/get-started/aspire-vscode-extension/) — install the CLI and use Aspire commands from within VS Code