From 5a8550dbb1b27a27d804a5d28d37c45ac42b783f Mon Sep 17 00:00:00 2001 From: Brandy Smith <6577830+brandyscarney@users.noreply.github.com> Date: Thu, 30 Jul 2026 09:36:35 -0400 Subject: [PATCH] docs(testing): update docker configuration instructions --- docs/core/testing/usage-instructions.md | 20 +++++++++++++++----- 1 file changed, 15 insertions(+), 5 deletions(-) diff --git a/docs/core/testing/usage-instructions.md b/docs/core/testing/usage-instructions.md index cccac3b8a55..9b3c5d6c23d 100644 --- a/docs/core/testing/usage-instructions.md +++ b/docs/core/testing/usage-instructions.md @@ -31,14 +31,24 @@ Rancher Desktop provides the Docker engine functionality needed to run our conta ### Installing Rancher Desktop -Rancher Desktop can be installed by [following the steps on the Rancher Desktop website](https://rancherdesktop.io/). +Install Rancher Desktop by following the instructions on the [Rancher Desktop website](https://rancherdesktop.io/). -After launching Rancher Desktop, choose the following settings to ensure Docker is properly configured: - - Uncheck "Enable Kubernetes" - - Choose Container Engine: `dockerd` (this enables the Docker Engine) +After launching Rancher Desktop, open **Preferences** and configure the following settings: + +- **Container Engine → General** + - Enable Kubernetes: Unchecked + - Container Engine: `dockerd` + +- **Application** - Configure PATH: Automatic -Once installed and configured, you can use all Docker commands through Rancher Desktop just as you would with Docker Desktop. All commands in this guide that reference Docker (such as `npm run test.e2e.docker`) will work through Rancher Desktop's Docker engine. +- **Virtual Machine** + - Emulation: `VZ` + - Volumes: `virtiofs` + +The **Virtual Machine** settings above are required for Docker to execute binaries correctly within mounted volumes during E2E tests. + +Once Rancher Desktop is configured, you can use Docker commands just as you would with Docker Desktop. ### Docker and Windows Development