From 411d182e8d957c5cdb36da0a08dde1e3b1e4d6f6 Mon Sep 17 00:00:00 2001 From: David Pine Date: Fri, 17 Jan 2025 14:00:45 -0600 Subject: [PATCH 1/8] WIP, backlog --- docs/fundamentals/setup-tooling.md | 33 ++++++++++++++++++++++++++++-- 1 file changed, 31 insertions(+), 2 deletions(-) diff --git a/docs/fundamentals/setup-tooling.md b/docs/fundamentals/setup-tooling.md index d30c1f11ab..668880ec75 100644 --- a/docs/fundamentals/setup-tooling.md +++ b/docs/fundamentals/setup-tooling.md @@ -23,7 +23,10 @@ To work with .NET Aspire, you need the following installed locally: - [.NET 8.0](https://dotnet.microsoft.com/download/dotnet/8.0) or [.NET 9.0](https://dotnet.microsoft.com/download/dotnet/9.0). - An OCI compliant container runtime, such as: - - [Docker Desktop](https://www.docker.com/products/docker-desktop) or [Podman](https://podman.io/). For more information, see [Container runtime](#container-runtime). + - [Docker Desktop](https://www.docker.com/products/docker-desktop) + - [Podman](https://podman.io/) + - [Rancher Desktop](https://rancherdesktop.io/) + - _For more information, see [Container runtime](#container-runtime)_. - An Integrated Developer Environment (IDE) or code editor, such as: - [Visual Studio 2022](https://visualstudio.microsoft.com/vs/) version 17.9 or higher (Optional) - [Visual Studio Code](https://code.visualstudio.com/) (Optional) @@ -136,7 +139,13 @@ For more information, see [.NET Aspire templates](aspire-sdk-templates.md). ## Container runtime -.NET Aspire projects are designed to run in containers. You can use either Docker Desktop or Podman as your container runtime. [Docker Desktop](https://www.docker.com/products/docker-desktop/) is the most common container runtime. [Podman](https://podman.io/docs/installation) is an open-source daemonless alternative to Docker, that can build and run Open Container Initiative (OCI) containers. If your host environment has both Docker and Podman installed, .NET Aspire defaults to using Docker. You can instruct .NET Aspire to use Podman instead, by setting the `ASPIRE_CONTAINER_RUNTIME` environment variable to `podman`: +.NET Aspire works seamlessly with containers, whether its dev-time orchestrator (app host) is creating and running containers as part of the app model. You can use a number of OCI-compatible container runtimes, including, Docker Desktop, Podman, or Rancher Desktop. + +- [Docker Desktop](https://www.docker.com/products/docker-desktop/) is the most common container runtime. +- [Podman](https://podman.io/docs/installation) is an open-source daemonless alternative to Docker, that can build and run Open Container Initiative (OCI) containers. +- [Rancher Desktop](https://rancherdesktop.io/) is also an open-source alternative, that sits atop other tools running as an Electron app—on macOS and Linux using a virtual machine, while on Windows leveraging the Windows Subsystem for Linux (WSL). + +If your host environment has a installed, .NET Aspire defaults to using Docker. You can instruct .NET Aspire to use Podman instead, by setting the `DOTNET_ASPIRE_CONTAINER_RUNTIME` environment variable to `podman`: ## [Linux](#tab/linux) @@ -156,6 +165,26 @@ For more information, see [Install Podman on Windows](https://podman.io/docs/ins --- +### Container runtime support matrix + +The following table shows the container runtimes supported by .NET Aspire: + +| Container runtime | Windows | macOS | Linux | +|-------------------|---------|-------|-------| +| Docker Desktop | ✔️ | ✔️ | ✔️ | +| Podman | ❌ | ❌ | ✔️ | +| Rancher Desktop | ✔️ | ✔️ | ✔️ | + +## .NET Aspire templates + +.NET Aspire provides a set of solution and project templates. These templates are available in your favorite .NET developer integrated environment. You can use these templates to create full .NET Aspire solutions, or add individual projects to existing .NET Aspire solutions. To install the .NET Aspire templates from their respective NuGet packages, use the following commands: + +```dotnetcli +dotnet new install Aspire.ProjectTemplates +``` + +For more information, see [.NET Aspire templates](aspire-sdk-templates.md). + ## .NET Aspire dashboard .NET Aspire templates that expose the [app host](app-host-overview.md) project also include a useful developer [dashboard](dashboard/overview.md) that's used to monitor and inspect various aspects of your app, such as logs, traces, and environment configurations. This dashboard is designed to improve the local development experience and provides an overview of the overall state and structure of your app. From 7309401a88a117e7dabf53b3490113767f6a0275 Mon Sep 17 00:00:00 2001 From: David Pine Date: Thu, 29 May 2025 15:42:43 -0500 Subject: [PATCH 2/8] Clarify rancher desktop support --- docs/fundamentals/setup-tooling.md | 15 +++++++++------ 1 file changed, 9 insertions(+), 6 deletions(-) diff --git a/docs/fundamentals/setup-tooling.md b/docs/fundamentals/setup-tooling.md index 668880ec75..831786ecbf 100644 --- a/docs/fundamentals/setup-tooling.md +++ b/docs/fundamentals/setup-tooling.md @@ -1,7 +1,7 @@ --- title: .NET Aspire tooling description: Learn about essential tooling concepts for .NET Aspire. -ms.date: 04/15/2025 +ms.date: 05/29/2025 zone_pivot_groups: dev-environment uid: dotnet/aspire/setup-tooling --- @@ -139,13 +139,16 @@ For more information, see [.NET Aspire templates](aspire-sdk-templates.md). ## Container runtime -.NET Aspire works seamlessly with containers, whether its dev-time orchestrator (app host) is creating and running containers as part of the app model. You can use a number of OCI-compatible container runtimes, including, Docker Desktop, Podman, or Rancher Desktop. +.NET Aspire supports running containers using various OCI-compatible runtimes, such as Docker Desktop, Podman, and Rancher Desktop. -- [Docker Desktop](https://www.docker.com/products/docker-desktop/) is the most common container runtime. -- [Podman](https://podman.io/docs/installation) is an open-source daemonless alternative to Docker, that can build and run Open Container Initiative (OCI) containers. -- [Rancher Desktop](https://rancherdesktop.io/) is also an open-source alternative, that sits atop other tools running as an Electron app—on macOS and Linux using a virtual machine, while on Windows leveraging the Windows Subsystem for Linux (WSL). +- [Docker Desktop](https://www.docker.com/products/docker-desktop/) is the most popular container runtime among .NET Aspire developers, offering a familiar and widely supported environment for building and running containers. +- [Podman](https://podman.io/docs/installation) is an open-source, daemonless alternative to Docker. It supports building and running Open Container Initiative (OCI) containers, making it a flexible choice for developers who prefer a lightweight solution. +- [Rancher Desktop](https://rancherdesktop.io/) is another open-source option that provides a user-friendly interface for managing containers. It runs as an Electron app and uses a virtual machine on macOS and Linux, while leveraging Windows Subsystem for Linux (WSL) on Windows. -If your host environment has a installed, .NET Aspire defaults to using Docker. You can instruct .NET Aspire to use Podman instead, by setting the `DOTNET_ASPIRE_CONTAINER_RUNTIME` environment variable to `podman`: +> [!IMPORTANT] +> Rancher Desktop is only supported with the default installation, where it relies on the Docker CLI. If you have configured Rancher Desktop to use the `nerdctl` CLI, .NET Aspire won't work with it. + +If your host environment has a Docker and Podman installed, .NET Aspire defaults to using Docker. You can instruct .NET Aspire to use Podman instead, by setting the `DOTNET_ASPIRE_CONTAINER_RUNTIME` environment variable to `podman`: ## [Linux](#tab/linux) From be1fae2b370d7128855c6eddf0701c16d647ef7b Mon Sep 17 00:00:00 2001 From: David Pine Date: Thu, 29 May 2025 15:47:43 -0500 Subject: [PATCH 3/8] Edit pass --- docs/fundamentals/setup-tooling.md | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/fundamentals/setup-tooling.md b/docs/fundamentals/setup-tooling.md index 831786ecbf..7def884133 100644 --- a/docs/fundamentals/setup-tooling.md +++ b/docs/fundamentals/setup-tooling.md @@ -143,10 +143,10 @@ For more information, see [.NET Aspire templates](aspire-sdk-templates.md). - [Docker Desktop](https://www.docker.com/products/docker-desktop/) is the most popular container runtime among .NET Aspire developers, offering a familiar and widely supported environment for building and running containers. - [Podman](https://podman.io/docs/installation) is an open-source, daemonless alternative to Docker. It supports building and running Open Container Initiative (OCI) containers, making it a flexible choice for developers who prefer a lightweight solution. -- [Rancher Desktop](https://rancherdesktop.io/) is another open-source option that provides a user-friendly interface for managing containers. It runs as an Electron app and uses a virtual machine on macOS and Linux, while leveraging Windows Subsystem for Linux (WSL) on Windows. +- [Rancher Desktop](https://rancherdesktop.io/) is another open-source option that provides a user-friendly interface for managing containers. It runs as an Electron app and uses a virtual machine on macOS and Linux, while using Windows Subsystem for Linux (WSL) on Windows. > [!IMPORTANT] -> Rancher Desktop is only supported with the default installation, where it relies on the Docker CLI. If you have configured Rancher Desktop to use the `nerdctl` CLI, .NET Aspire won't work with it. +> .NET Aspire supports Rancher Desktop only with the default Docker CLI setup. If you configure Rancher Desktop to use the `nerdctl` CLI, .NET Aspire can't use it. If your host environment has a Docker and Podman installed, .NET Aspire defaults to using Docker. You can instruct .NET Aspire to use Podman instead, by setting the `DOTNET_ASPIRE_CONTAINER_RUNTIME` environment variable to `podman`: @@ -206,7 +206,7 @@ The .NET Aspire dashboard is also available in a standalone mode. For more infor ## Visual Studio tooling -Visual Studio provides additional features for working with .NET Aspire integrations and the App Host orchestrator project. Not all of these features are currently available in Visual Studio Code or through the CLI. +Visual Studio provides extra features for working with .NET Aspire integrations and the App Host orchestrator project. Not all of these features are currently available in Visual Studio Code or through the CLI. ### Add an integration package @@ -224,7 +224,7 @@ For more information on .NET Aspire integrations, see [.NET Aspire integrations ### Add hosting packages -.NET Aspire hosting packages are used to configure various resources and dependencies an app may depend on or consume. Hosting packages are differentiated from other integration packages in that they're added to the _*.AppHost_ project. To add a hosting package to your app, follow these steps: +.NET Aspire hosting packages are used to configure various resources and dependencies an app might depend on or consume. Hosting packages are differentiated from other integration packages in that they're added to the _*.AppHost_ project. To add a hosting package to your app, follow these steps: 1. In Visual Studio, right select on the _*.AppHost_ project and select **Add** > **.NET Aspire package...**. From 3103e4519ec8ef03a414e42778caa212906c0c37 Mon Sep 17 00:00:00 2001 From: David Pine Date: Thu, 29 May 2025 15:53:47 -0500 Subject: [PATCH 4/8] Fix matrix --- docs/fundamentals/setup-tooling.md | 12 +----------- 1 file changed, 1 insertion(+), 11 deletions(-) diff --git a/docs/fundamentals/setup-tooling.md b/docs/fundamentals/setup-tooling.md index 7def884133..1307e650a0 100644 --- a/docs/fundamentals/setup-tooling.md +++ b/docs/fundamentals/setup-tooling.md @@ -146,7 +146,7 @@ For more information, see [.NET Aspire templates](aspire-sdk-templates.md). - [Rancher Desktop](https://rancherdesktop.io/) is another open-source option that provides a user-friendly interface for managing containers. It runs as an Electron app and uses a virtual machine on macOS and Linux, while using Windows Subsystem for Linux (WSL) on Windows. > [!IMPORTANT] -> .NET Aspire supports Rancher Desktop only with the default Docker CLI setup. If you configure Rancher Desktop to use the `nerdctl` CLI, .NET Aspire can't use it. +> .NET Aspire supports Rancher Desktop only with the default Docker CLI setup. If you configure Rancher Desktop to use the `nerdctl` CLI, it isn't supported. If your host environment has a Docker and Podman installed, .NET Aspire defaults to using Docker. You can instruct .NET Aspire to use Podman instead, by setting the `DOTNET_ASPIRE_CONTAINER_RUNTIME` environment variable to `podman`: @@ -168,16 +168,6 @@ For more information, see [Install Podman on Windows](https://podman.io/docs/ins --- -### Container runtime support matrix - -The following table shows the container runtimes supported by .NET Aspire: - -| Container runtime | Windows | macOS | Linux | -|-------------------|---------|-------|-------| -| Docker Desktop | ✔️ | ✔️ | ✔️ | -| Podman | ❌ | ❌ | ✔️ | -| Rancher Desktop | ✔️ | ✔️ | ✔️ | - ## .NET Aspire templates .NET Aspire provides a set of solution and project templates. These templates are available in your favorite .NET developer integrated environment. You can use these templates to create full .NET Aspire solutions, or add individual projects to existing .NET Aspire solutions. To install the .NET Aspire templates from their respective NuGet packages, use the following commands: From f9cd42b7f416d1574432158b6b0c0cc3a4029a99 Mon Sep 17 00:00:00 2001 From: David Pine Date: Thu, 29 May 2025 15:55:28 -0500 Subject: [PATCH 5/8] Remove dup section from bad rebase --- docs/fundamentals/setup-tooling.md | 10 ---------- 1 file changed, 10 deletions(-) diff --git a/docs/fundamentals/setup-tooling.md b/docs/fundamentals/setup-tooling.md index 1307e650a0..a76c1bc8b1 100644 --- a/docs/fundamentals/setup-tooling.md +++ b/docs/fundamentals/setup-tooling.md @@ -168,16 +168,6 @@ For more information, see [Install Podman on Windows](https://podman.io/docs/ins --- -## .NET Aspire templates - -.NET Aspire provides a set of solution and project templates. These templates are available in your favorite .NET developer integrated environment. You can use these templates to create full .NET Aspire solutions, or add individual projects to existing .NET Aspire solutions. To install the .NET Aspire templates from their respective NuGet packages, use the following commands: - -```dotnetcli -dotnet new install Aspire.ProjectTemplates -``` - -For more information, see [.NET Aspire templates](aspire-sdk-templates.md). - ## .NET Aspire dashboard .NET Aspire templates that expose the [app host](app-host-overview.md) project also include a useful developer [dashboard](dashboard/overview.md) that's used to monitor and inspect various aspects of your app, such as logs, traces, and environment configurations. This dashboard is designed to improve the local development experience and provides an overview of the overall state and structure of your app. From 7ac061c563ab8dc41233607c55a149f63e0848d0 Mon Sep 17 00:00:00 2001 From: David Pine Date: Fri, 30 May 2025 08:03:29 -0500 Subject: [PATCH 6/8] Adjust text based on peer feedback --- docs/fundamentals/setup-tooling.md | 5 +---- 1 file changed, 1 insertion(+), 4 deletions(-) diff --git a/docs/fundamentals/setup-tooling.md b/docs/fundamentals/setup-tooling.md index a76c1bc8b1..3ecd8b8c69 100644 --- a/docs/fundamentals/setup-tooling.md +++ b/docs/fundamentals/setup-tooling.md @@ -139,15 +139,12 @@ For more information, see [.NET Aspire templates](aspire-sdk-templates.md). ## Container runtime -.NET Aspire supports running containers using various OCI-compatible runtimes, such as Docker Desktop, Podman, and Rancher Desktop. +.NET Aspire can run containers using several OCI-compatible runtimes, including Docker Desktop, Podman, and Rancher Desktop. In addition to an OCI-compatible runtime, .NET Aspire requires a supported command-line interface (CLI) for container management. Currently, only the Docker CLI and Podman CLI are supported. For example, Rancher Desktop is supported when configured to use the Docker CLI, but not when using the `nerdctl` CLI. - [Docker Desktop](https://www.docker.com/products/docker-desktop/) is the most popular container runtime among .NET Aspire developers, offering a familiar and widely supported environment for building and running containers. - [Podman](https://podman.io/docs/installation) is an open-source, daemonless alternative to Docker. It supports building and running Open Container Initiative (OCI) containers, making it a flexible choice for developers who prefer a lightweight solution. - [Rancher Desktop](https://rancherdesktop.io/) is another open-source option that provides a user-friendly interface for managing containers. It runs as an Electron app and uses a virtual machine on macOS and Linux, while using Windows Subsystem for Linux (WSL) on Windows. -> [!IMPORTANT] -> .NET Aspire supports Rancher Desktop only with the default Docker CLI setup. If you configure Rancher Desktop to use the `nerdctl` CLI, it isn't supported. - If your host environment has a Docker and Podman installed, .NET Aspire defaults to using Docker. You can instruct .NET Aspire to use Podman instead, by setting the `DOTNET_ASPIRE_CONTAINER_RUNTIME` environment variable to `podman`: ## [Linux](#tab/linux) From 7cdbbb464592d78b3320751a59e9994989b34e16 Mon Sep 17 00:00:00 2001 From: David Pine Date: Fri, 30 May 2025 11:51:24 -0500 Subject: [PATCH 7/8] Update rancher support scenarios --- docs/fundamentals/setup-tooling.md | 6 ++---- docs/index.yml | 4 ++-- docs/toc.yml | 8 ++++---- 3 files changed, 8 insertions(+), 10 deletions(-) diff --git a/docs/fundamentals/setup-tooling.md b/docs/fundamentals/setup-tooling.md index 3ecd8b8c69..ced4eedae6 100644 --- a/docs/fundamentals/setup-tooling.md +++ b/docs/fundamentals/setup-tooling.md @@ -25,8 +25,7 @@ To work with .NET Aspire, you need the following installed locally: - An OCI compliant container runtime, such as: - [Docker Desktop](https://www.docker.com/products/docker-desktop) - [Podman](https://podman.io/) - - [Rancher Desktop](https://rancherdesktop.io/) - - _For more information, see [Container runtime](#container-runtime)_. + - _For more information, see [Container runtime](#container-runtime)_. - An Integrated Developer Environment (IDE) or code editor, such as: - [Visual Studio 2022](https://visualstudio.microsoft.com/vs/) version 17.9 or higher (Optional) - [Visual Studio Code](https://code.visualstudio.com/) (Optional) @@ -139,11 +138,10 @@ For more information, see [.NET Aspire templates](aspire-sdk-templates.md). ## Container runtime -.NET Aspire can run containers using several OCI-compatible runtimes, including Docker Desktop, Podman, and Rancher Desktop. In addition to an OCI-compatible runtime, .NET Aspire requires a supported command-line interface (CLI) for container management. Currently, only the Docker CLI and Podman CLI are supported. For example, Rancher Desktop is supported when configured to use the Docker CLI, but not when using the `nerdctl` CLI. +.NET Aspire can run containers using several OCI-compatible runtimes, including Docker Desktop and Podman. While some users have reported success using [Rancher Desktop](https://rancherdesktop.io/)—particularly when configured to use the Docker CLI—this is not an officially supported or regularly tested scenario. It might be possible to use Rancher Desktop with the default installation, but it's not an officially supported or validated approach. If you encounter issues with Rancher Desktop, please let us know, but be aware that fixes may not be prioritized. - [Docker Desktop](https://www.docker.com/products/docker-desktop/) is the most popular container runtime among .NET Aspire developers, offering a familiar and widely supported environment for building and running containers. - [Podman](https://podman.io/docs/installation) is an open-source, daemonless alternative to Docker. It supports building and running Open Container Initiative (OCI) containers, making it a flexible choice for developers who prefer a lightweight solution. -- [Rancher Desktop](https://rancherdesktop.io/) is another open-source option that provides a user-friendly interface for managing containers. It runs as an Electron app and uses a virtual machine on macOS and Linux, while using Windows Subsystem for Linux (WSL) on Windows. If your host environment has a Docker and Podman installed, .NET Aspire defaults to using Docker. You can instruct .NET Aspire to use Podman instead, by setting the `DOTNET_ASPIRE_CONTAINER_RUNTIME` environment variable to `podman`: diff --git a/docs/index.yml b/docs/index.yml index 0364d53fab..ff0f19b752 100644 --- a/docs/index.yml +++ b/docs/index.yml @@ -11,7 +11,7 @@ metadata: description: Learn about .NET Aspire, a cloud-ready stack for building distributed applications. Browse API reference, tutorials, and more. ms.topic: hub-page ms.service: dotnet-aspire - ms.date: 02/25/2025 + ms.date: 05/30/2025 highlightedContent: items: @@ -360,7 +360,7 @@ additionalContent: items: - title: ".NET Aspire API reference" summary: API reference documentation for .NET Aspire - url: /dotnet/api?view=dotnet-aspire-9.2&preserve-view=true + url: /dotnet/api?view=dotnet-aspire-9.3&preserve-view=true - title: ".NET API reference" summary: API reference documentation for .NET url: /dotnet/api?view=net-9.0&preserve-view=true diff --git a/docs/toc.yml b/docs/toc.yml index 5d8802fc9f..4e4bdefe24 100644 --- a/docs/toc.yml +++ b/docs/toc.yml @@ -226,9 +226,9 @@ items: displayName: web pubsub,real-time,messaging href: messaging/azure-web-pubsub-integration.md - name: Aspire.Hosting.Azure API reference - href: /dotnet/api/?term=Aspire.Hosting.Azure&view=dotnet-aspire-9.2&preserve-view=true + href: /dotnet/api/?term=Aspire.Hosting.Azure&view=dotnet-aspire-9.3&preserve-view=true - name: Aspire.Azure API reference - href: /dotnet/api/?term=Aspire.Azure&view=dotnet-aspire-9.2&preserve-view=true + href: /dotnet/api/?term=Aspire.Azure&view=dotnet-aspire-9.3&preserve-view=true - name: Elasticsearch displayName: elasticsearch,search href: search/elasticsearch-integration.md @@ -371,7 +371,7 @@ items: - name: RavenDB href: community-toolkit/ravendb.md - name: Aspire.Hosting API reference - href: /dotnet/api/?term=Aspire.Hosting&view=dotnet-aspire-9.2&preserve-view=true + href: /dotnet/api/?term=Aspire.Hosting&view=dotnet-aspire-9.3&preserve-view=true - name: Custom integrations items: @@ -507,7 +507,7 @@ items: - name: Publishing to Azure APIs are experimental href: diagnostics/aspireazure001.md - name: .NET Aspire API reference - href: /dotnet/api?view=dotnet-aspire-9.2&preserve-view=true + href: /dotnet/api?view=dotnet-aspire-9.3&preserve-view=true - name: .NET Aspire FAQ displayName: iis,functions,deploy,azure,kubernetes href: reference/aspire-faq.yml From 15901832d78fe104807ef5707905a8d344a9a9da Mon Sep 17 00:00:00 2001 From: David Pine Date: Fri, 30 May 2025 12:03:12 -0500 Subject: [PATCH 8/8] Quick edit pass --- docs/fundamentals/setup-tooling.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/fundamentals/setup-tooling.md b/docs/fundamentals/setup-tooling.md index ced4eedae6..a4fb2e10ef 100644 --- a/docs/fundamentals/setup-tooling.md +++ b/docs/fundamentals/setup-tooling.md @@ -1,7 +1,7 @@ --- title: .NET Aspire tooling description: Learn about essential tooling concepts for .NET Aspire. -ms.date: 05/29/2025 +ms.date: 05/30/2025 zone_pivot_groups: dev-environment uid: dotnet/aspire/setup-tooling --- @@ -104,7 +104,7 @@ dotnet new install Aspire.ProjectTemplates::9.3.0 :::zone pivot="visual-studio" -The .NET Aspire templates are installed automatically when you install Visual Studio 17.9 or later. To see what .NET Aspire templates are available, select **File** > **New** > **Project** in Visual Studio, and search for "Aspire" in the search bar (Alt+S). You'll see a list of available .NET Aspire project templates: +The .NET Aspire templates are installed automatically when you install Visual Studio 17.9 or later. To see what .NET Aspire templates are available, select **File** > **New** > **Project** in Visual Studio, and search for "Aspire" in the search bar (Alt+S). You see a list of available .NET Aspire project templates: :::image type="content" source="media/vs-create-dotnet-aspire-proj.png" alt-text="Visual Studio: Create new project and search for 'Aspire'." lightbox="media/vs-create-dotnet-aspire-proj.png"::: @@ -138,7 +138,7 @@ For more information, see [.NET Aspire templates](aspire-sdk-templates.md). ## Container runtime -.NET Aspire can run containers using several OCI-compatible runtimes, including Docker Desktop and Podman. While some users have reported success using [Rancher Desktop](https://rancherdesktop.io/)—particularly when configured to use the Docker CLI—this is not an officially supported or regularly tested scenario. It might be possible to use Rancher Desktop with the default installation, but it's not an officially supported or validated approach. If you encounter issues with Rancher Desktop, please let us know, but be aware that fixes may not be prioritized. +.NET Aspire can run containers using several OCI-compatible runtimes, including Docker Desktop and Podman. While some users have reported success using [Rancher Desktop](https://rancherdesktop.io/)—particularly when configured to use the Docker CLI—this isn't an officially supported or regularly tested scenario. It might be possible to use Rancher Desktop with the default installation, but it's not an officially supported or validated approach. If you encounter issues with Rancher Desktop, please let us know, but be aware that fixes might not be prioritized. - [Docker Desktop](https://www.docker.com/products/docker-desktop/) is the most popular container runtime among .NET Aspire developers, offering a familiar and widely supported environment for building and running containers. - [Podman](https://podman.io/docs/installation) is an open-source, daemonless alternative to Docker. It supports building and running Open Container Initiative (OCI) containers, making it a flexible choice for developers who prefer a lightweight solution.