|
| 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. |
0 commit comments