Skip to content

Commit bc13861

Browse files
ENGDOCS-2595 (docker#22530)
<!--Delete sections as needed --> ## Description Adds docs on DD on Microsoft Dev Box ## Related issues or tickets <!-- Related issues, pull requests, or Jira tickets --> ## Reviews <!-- Notes for reviewers here --> <!-- List applicable reviews (optionally @tag reviewers) --> - [ ] Technical review - [ ] Editorial review - [ ] Product review --------- Co-authored-by: Sarah Sanders <[email protected]>
1 parent d8b9d35 commit bc13861

File tree

2 files changed

+59
-0
lines changed

2 files changed

+59
-0
lines changed
Lines changed: 55 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,55 @@
1+
---
2+
Title: Docker Desktop in Microsoft Dev Box
3+
description: Learn about the benefits of and how to setup Docker Desktop in Microsoft Dev Box
4+
keywords: desktop, docker, windows, microsoft dev box
5+
---
6+
7+
Docker Desktop is available as a pre-configured image in the Microsoft Azure Marketplace for use with Microsoft Dev Box, allowing developers to quickly set up consistent development environments in the cloud.
8+
9+
Microsoft Dev Box provides cloud-based, pre-configured developer workstations that allow you to code, build, and test applications without configuring a local development environment. The Docker Desktop image for Microsoft Dev Box comes with Docker Desktop and its dependencies pre-installed, giving you a ready-to-use containerized development environment.
10+
11+
## Key benefits
12+
13+
- Pre-configured environment: Docker Desktop, WSL2, and other requirements come pre-installed and configured
14+
- Consistent development: Ensure all team members work with the same Docker environment
15+
- Powerful resources: Access more compute power and storage than might be available on local machines
16+
- State persistence: Dev Box maintains your state between sessions, similar to hibernating a local machine
17+
- Seamless licensing: Use your existing Docker subscription or purchase a new one directly through Azure Marketplace
18+
19+
## Setup
20+
21+
### Prerequisites
22+
23+
- An Azure subscription
24+
- Access to Microsoft Dev Box
25+
- A Docker subscription (Pro, Team, or Business). You can use Docker Desktop in Microsoft Dev Box with any of the following subscription options:
26+
- An existing or new Docker subscription
27+
- A new Docker subscription purchased through Azure Marketplace
28+
- A Docker Business subscription with SSO configured for your organization
29+
30+
### Set up Docker Desktop in Dev Box
31+
32+
1. Navigate to the [Docker Desktop for Microsoft Dev Box](https://azuremarketplace.microsoft.com/en-us/marketplace/apps/dockerinc1694120899427.devbox_azuremachine?tab=Overview) listing in Azure Marketplace.
33+
2. Select **Get It Now** to add the virtual machine image to your subscription.
34+
3. Follow the Azure workflow to complete the setup.
35+
4. Use the image to create VMs, assign to Dev Centers, or create Dev Box Pools according to your organization's setup.
36+
37+
### Activate Docker Desktop
38+
39+
Once your Dev Box is provisioned with the Docker Desktop image:
40+
41+
1. Start your Dev Box instance.
42+
2. Launch Docker Desktop.
43+
3. Sign in with your Docker ID.
44+
45+
## Support
46+
47+
For issues related to:
48+
49+
- Docker Desktop configuration, usage, or licensing: Create a support ticket through [Docker Support](https://hub.docker.com/support).
50+
- Dev Box creation, Azure portal configuration, or networking: Contact Azure Support.
51+
52+
## Limitations
53+
54+
- Microsoft Dev Box is currently only available on Windows 10 and 11 (Linux VMs are not supported).
55+
- Performance may vary based on your Dev Box configuration and network conditions.

content/manuals/desktop/setup/vm-vdi.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -64,3 +64,7 @@ Docker Desktop follows the VDI support definitions outlined [previously](#virtua
6464
### Support scope and responsibilities
6565

6666
For WSL 2-related issues, contact Nutanix support. For Docker Desktop-specific issues, contact Docker support.
67+
68+
## Aditional resources
69+
70+
- [Docker Desktop on Microsoft Dev Box](/manuals/desktop/features/dev-box.md)

0 commit comments

Comments
 (0)