Skip to content

ENGDOCS-2595 #22530

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 3 commits into from
May 8, 2025
Merged

ENGDOCS-2595 #22530

Show file tree
Hide file tree
Changes from 2 commits
Commits
Show all changes
3 commits
Select commit Hold shift + click to select a range
84efc52
ENGDOCS-2595
aevesdocker Apr 30, 2025
92c5a89
ENGDOCS-2595
aevesdocker Apr 30, 2025
05b51d1
Apply suggestions from code review
aevesdocker May 1, 2025
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
55 changes: 55 additions & 0 deletions content/manuals/desktop/features/dev-box.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,55 @@
---
Title: Docker Desktop in Microsoft Dev Box
description: Learn about the benefits of and how to setup Docker Desktop in Microsoft Dev Box
keywords: desktop, docker, windows, microsoft dev box

Check failure on line 4 in content/manuals/desktop/features/dev-box.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Vale.Terms] Use 'Microsoft' instead of 'microsoft'.

Raw Output:
{"message": "[Vale.Terms] Use 'Microsoft' instead of 'microsoft'.", "location": {"path": "content/manuals/desktop/features/dev-box.md", "range": {"start": {"line": 4, "column": 37}}}, "severity": "ERROR"}

Check failure on line 4 in content/manuals/desktop/features/dev-box.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Vale.Terms] Use 'Dev' instead of 'dev'.

Raw Output:
{"message": "[Vale.Terms] Use 'Dev' instead of 'dev'.", "location": {"path": "content/manuals/desktop/features/dev-box.md", "range": {"start": {"line": 4, "column": 47}}}, "severity": "ERROR"}
---

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.

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.

Check warning on line 9 in content/manuals/desktop/features/dev-box.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Docker.RecommendedWords] Consider using 'let' instead of 'allow'

Raw Output:
{"message": "[Docker.RecommendedWords] Consider using 'let' instead of 'allow'", "location": {"path": "content/manuals/desktop/features/dev-box.md", "range": {"start": {"line": 9, "column": 84}}}, "severity": "INFO"}

## Key benefits

- Pre-configured environment: Docker Desktop, WSL2, and other requirements come pre-installed and configured
- Consistent development: Ensure all team members work with the same Docker environment
- Powerful resources: Access more compute power and storage than might be available on local machines
- State persistence: Dev Box maintains your state between sessions, similar to hibernating a local machine
- Seamless licensing: Use your existing Docker subscription or purchase a new one directly through Azure Marketplace

## Setup

### Prerequisites

- An Azure subscription
- Access to Microsoft Dev Box
- A Docker subscription (Pro, Team, or Business). You can use Docker Desktop in Microsoft Dev Box with any of the following subscription options:
- An existing or new Docker subscription
- A new Docker subscription purchased through Azure Marketplace
- A Docker Business subscription with SSO configured for your organization

### Setting up Docker Desktop in Dev Box

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.
2. Select **Get It Now** to add the virtual machine image to your subscription
3. Follow the Azure workflow to complete the setup
4. Use the image to create VMs, assign to Dev Centers, or create Dev Box Pools according to your organization's setup

### Activate Docker Desktop

Once your Dev Box is provisioned with the Docker Desktop image:

1. Start your Dev Box instance.
2. Launch Docker Desktop.
3. Sign in with your Docker ID

## Support

For issues related to:

- Docker Desktop configuration, usage, or licensing: Create a support ticket through [Docker Support](https://hub.docker.com/support)
- Dev Box creation, Azure portal configuration, or networking: Contact Azure Support

## Limitations

- Microsoft Dev Box is currently only available on Windows 10 & 11 (Linux VMs are not supported)
- Performance may vary based on your Dev Box configuration and network conditions
4 changes: 4 additions & 0 deletions content/manuals/desktop/setup/vm-vdi.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -64,3 +64,7 @@
### Support scope and responsibilities

For WSL 2-related issues, contact Nutanix support. For Docker Desktop-specific issues, contact Docker support.

## Aditional resources

Check failure on line 68 in content/manuals/desktop/setup/vm-vdi.md

View workflow job for this annotation

GitHub Actions / vale 

[vale] reported by reviewdog 🐶
[Vale.Spelling] Did you really mean 'Aditional'?

Raw Output:
{"message": "[Vale.Spelling] Did you really mean 'Aditional'?", "location": {"path": "content/manuals/desktop/setup/vm-vdi.md", "range": {"start": {"line": 68, "column": 4}}}, "severity": "ERROR"}

- [Docker Desktop on Microsoft Dev Box](/manuals/desktop/features/dev-box.md)