Set up your machine to use the latest Aspire builds

If you just want an official release of Aspire, you don't need this document. The Aspire documentation will get you started.

If you want the latest, unsupported build of Aspire to try, read on.

Prepare the machine

See machine-requirements.md.

Install the daily CLI only

On Windows:

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

On Linux, or macOS:

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

Install the daily CLI + VS Code extension

The Aspire VS Code extension requires the Aspire CLI to be available on the path to work. You can install both using the installation script.

On Windows:

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

On Linux, or macOS:

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

Note: to install the Aspire extension to VS Code Insiders, add the -UseInsiders (PowerShell) or --use-insiders flag.

Create a new Project

Create an empty Aspire project on the command line:

aspire new

Running through the wizard will allow you to select a channel (daily/stable etc).

Enter the project name (aspire-projects): dailybuild0
Enter the output path (./dailybuild0): ./dailybuild0
✔  Using Redis Cache for caching.
Select a template version:

   9.4.1 (nuget.org)
>  daily
   stable

(Type to search)

When complete, the CLI will create a NuGet.config to make sure that packages are restored from the correct nuget feed.

Updating an Existing Project

If you have an existing Aspire project and want to update it to use the latest daily build, you can run:

aspire update

This will update the project to use the daily packages and feeds.

After updating your project, you can run it using the following command:

aspire run