desktop,cloud: add vdi beta (#22696)

<!--Delete sections as needed -->

## Description

Added Cloud VDI Beta


https://deploy-preview-22696--docsdocker.netlify.app/desktop/setup/vm-vdi/

## Related issues or tickets

ENGDOCS-2649

## Reviews

<!-- Notes for reviewers here -->
<!-- List applicable reviews (optionally @tag reviewers) -->

- [ ] Technical review
- [ ] Editorial review
- [ ] Product review

---------

Signed-off-by: Craig <craig.osterhout@docker.com>
Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>
This commit is contained in:
Craig Osterhout 2025-06-04 06:47:44 -07:00 committed by GitHub
parent 643956d16d
commit 347733c276
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
3 changed files with 89 additions and 5 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 457 B

View File

@ -9,11 +9,91 @@ aliases:
weight: 30
---
Docker recommends running Docker Desktop natively on Mac, Linux, or Windows. However, Docker Desktop for Windows can run inside a virtual desktop provided the virtual desktop is properly configured.
Docker recommends running Docker Desktop natively on Mac, Linux, or Windows. However, Docker Desktop for Windows can run inside a virtual desktop provided the virtual desktop is properly configured.
To run Docker Desktop in a virtual desktop environment, it is essential nested virtualization is enabled on the virtual machine that provides the virtual desktop. This is because, under the hood, Docker Desktop is using a Linux VM in which it runs Docker Engine and the containers.
To run Docker Desktop in a virtual desktop environment, you have two options,
depending on whether nested virtualization is supported:
## Virtual desktop support
- If your environment supports nested virtualization, you can run Docker Desktop
with its default local Linux VM.
- If nested virtualization is not supported, Docker recommends using Docker
Cloud. To join the beta, contact Docker at `docker-cloud@docker.com`.
## Use Docker Cloud
{{< summary-bar feature_name="Docker Cloud" >}}
Docker Cloud lets you offload container workloads to a high-performance,
fully hosted cloud environment, enabling a seamless hybrid experience. It
includes an insights dashboard that offers performance metrics and environment
management to help optimize your development workflow.
This mode is useful in virtual desktop environments where nested virtualization
isn't supported. In these environments, Docker Desktop defaults to using
cloud mode to ensure you can still build and run containers without relying on
local virtualization.
Docker Cloud decouples the Docker Desktop client from the Docker Engine,
allowing the Docker CLI and Docker Desktop Dashboard to interact with
cloud-based resources as if they were local. When you run a container, Docker
provisions a secure, isolated, and ephemeral cloud environment connected to
Docker Desktop via an SSH tunnel. Despite running remotely, features like bind
mounts and port forwarding continue to work seamlessly, providing a local-like
experience. To use Docker Cloud:
1. Contact Docker at `docker-cloud@docker.com` to activate the feature for your
account.
2. [Install Docker Desktop](/manuals/desktop/setup/install/windows-install.md#install-docker-desktop-on-windows)
version 4.42 or later on your Windows virtual desktop.
3. [Start Docker Desktop](/manuals/desktop/setup/install/windows-install.md#start-docker-desktop).
4. Sign in to Docker Desktop.
After you sign in, Docker Cloud is enabled by default and cannot be
disabled. When enabled, Docker Desktop's Dashboard header appears purple and the
cloud-mode toggle is a cloud icon ({{< inline-image
src="./images/cloud-mode.png" alt="Cloud mode icon" >}}).
In this mode, Docker Desktop mirrors your cloud environment, providing
a seamless view of your containers and resources running on Docker Cloud. You
can verify that Docker Cloud is working by running a simple container. In a
terminal on your virtual desktop, run the following command:
```console
$ docker run hello-world
```
In the terminal, you will see `Hello from Docker!` if everything is working
correctly.
### View insights and manage Docker Cloud
For insights and management, use the [Docker Cloud
Dashboard](https://app.docker.com/cloud). It provides visibility into your
builds, runs, and cloud resource usage. Key features include:
- Overview: Monitor cloud usage, build cache, and top repositories built.
- Build history: Review past builds with filtering and sorting options.
- Run history: Track container runs and sort by various options.
- Integrations: Learn how to set up cloud builders and runners for your CI
pipeline.
- Settings: Manage cloud builders, usage, and account settings.
Access the Docker Cloud Dashboard at https://app.docker.com/cloud.
### Limitations
The following limitations apply when using Docker Cloud:
- Persistence: Containers are launched in a cloud engine that remains available
as long as you interact with and consume the containers' output. After closing
Docker Desktop, or about 30 minutes of inactivity, the engine is shut down and
becomes inaccessible, along with any data stored in it, including images,
containers, and volumes. A new engine is provisioned for any new workloads.
- Usage and billing: During beta, no charges are incurred for using Docker Cloud
resources. Docker enforces a usage cap and reserves the right to disable
Docker Cloud access at any time.
## Virtual desktop support when using nested virtualization
> [!NOTE]
>
@ -33,7 +113,8 @@ Docker does not support running multiple instances of Docker Desktop on the same
## Turn on nested virtualization
You must turn on nested virtualization before you install Docker Desktop on a virtual machine.
You must turn on nested virtualization before you install Docker Desktop on a
virtual machine that will not use Docker Cloud.
### Turn on nested virtualization on VMware ESXi
@ -55,7 +136,7 @@ If using Windows container mode, confirm that the Nutanix environment supports H
### Supported configurations
Docker Desktop follows the VDI support definitions outlined [previously](#virtual-desktop-support):
Docker Desktop follows the VDI support definitions outlined [previously](#virtual-desktop-support-when-using-nested-virtualization):
- Persistent VDI environments (Supported): You receive the same virtual desktop instance across sessions, preserving installed software and configurations.

View File

@ -135,6 +135,9 @@ Docker Build Cloud:
subscription: [Pro, Team, Business]
Docker CLI OpenTelemetry:
requires: Docker Engine [26.1.0](/manuals/engine/release-notes/26.1.md#2610) and later
Docker Cloud:
availability: Beta
requires: Docker Desktop 4.42 and later
docker compose alpha:
availability: Experimental
Docker Debug: