Quickstart: Configure the Microsoft Dev Box service

This quickstart describes how to configure the Microsoft Dev Box service by using the Azure portal to enable development teams to self-serve dev boxes.

In this quickstart, you'll perform the following tasks:

Prerequisites

To complete this quick start, make sure that you have:

  • An Azure account with an active subscription. Create an account for free.
  • Owner or Contributor permissions on an Azure Subscription or a specific resource group.
  • Network Contributor permissions on an existing virtual network (owner or contributor) or permission to create a new virtual network and subnet.

Create a dev center

The following steps show you how to create and configure a dev center.

  1. Sign in to the Azure portal.

  2. In the search box, type Dev centers and then select Dev centers from the list.

  3. On the dev centers page, select +Create. Screenshot showing the Azure portal Dev center with create highlighted.

  4. On the Create a dev center page, on the Basics tab, enter the following values:

    Name Value
    Subscription Select the subscription in which you want to create the dev center.
    Resource group Select an existing resource group or select Create new, and enter a name for the resource group.
    Name Enter a name for your dev center.
    Location Select the location/region you want the dev center to be created in.

    Screenshot showing the Create dev center Basics tab.

    The currently supported Azure locations with capacity are listed here: Microsoft Dev Box.

  5. [Optional] On the Tags tab, enter a name and value pair that you want to assign. Screenshot showing the Create dev center Tags tab.

  6. Select Review + Create.

  7. On the Review tab, select Create.

  8. You can check on the progress of the dev center creation from any page in the Azure portal by opening the notifications pane. Screenshot showing Azure portal notifications pane.

  9. When the deployment is complete, select Go to resource. You'll see the dev center page.

Create a network connection

Network connections determine the region into which dev boxes are deployed and allow them to be connected to your existing virtual networks. The following steps show you how to create and configure a network connection in Microsoft Dev Box.

To perform the steps in this section, you must have an existing virtual network (vnet) and subnet. If you don't have a vnet and subnet available, follow the instructions here: Quickstart: Create a virtual network using the Azure portal to create them.

If your organization routes egress traffic through a firewall, you need to open certain ports to allow the Dev Box service to function. For more information, see Network requirements.

  1. Sign in to the Azure portal.

  2. In the search box, type Network connections and then select Network connections from the list.

  3. On the Network Connections page, select +Create. Screenshot showing the Network Connections page with Create highlighted.

  4. Follow the steps on the appropriate tab to create your network connection.

    On the Create a network connection page, on the Basics tab, enter the following values:

    Name Value
    Domain join type Select Azure active directory join.
    Subscription Select the subscription in which you want to create the network connection.
    Resource group Select an existing resource group or select Create new, and enter a name for the resource group.
    Name Enter a descriptive name for your network connection.
    Virtual network Select the virtual network you want the network connection to use.
    Subnet Select the subnet you want the network connection to use.

    Screenshot showing the create network connection basics tab with Azure Active Directory join highlighted.


  1. Select Review + Create.

  2. On the Review tab, select Create.

  3. When the deployment is complete, select Go to resource. You'll see the Network Connection overview page.

Attach network connection to dev center

You need to attach a network connection to a dev center before it can be used in projects to create dev box pools.

  1. In the Azure portal, in the search box, type Dev centers and then select Dev centers from the list.

  2. Select the dev center you created and select Networking.

  3. Select + Add.

  4. In the Add network connection pane, select the network connection you created earlier, and then select Add.

After creation, several health checks are run on the network. You can view the status of the checks on the resource overview page. Network connections that pass all the health checks can be added to a dev center and used in the creation of dev box pools. The dev boxes within the dev box pools will be created and domain joined in the location of the vnet assigned to the network connection.

Screenshot showing the status of a network connection.

To resolve any errors, refer to the Troubleshoot Azure network connections.

Create a dev box definition

The following steps show you how to create and configure a dev box definition. You can use dev box definitions across multiple projects in the same dev center. Dev box definitions define the image and SKU (compute + storage) that will be used in creation of the dev boxes.

  1. Open the dev center in which you want to create the dev box definition.

  2. Select Dev box definitions.

  3. On the Dev box definitions page, select +Create.

  4. On the Create dev box definition page, enter the following values:

    Enter the following values:

    Name Value Note
    Name Enter a descriptive name for your dev box definition.
    Image Select the base operating system for the dev box. You can select an image from the marketplace or from an Azure Compute Gallery. To use custom images while creating a dev box definition, you can attach an Azure Compute Gallery that has the custom images. Learn How to configure an Azure Compute Gallery.
    Image version Select a specific, numbered version to ensure all the dev boxes in the pool always use the same version of the image. Select Latest to ensure new dev boxes use the latest image available. Selecting the Latest image version enables the dev box pool to use the most recent image version for your chosen image from the gallery. This way, the dev boxes created will stay up to date with the latest tools and code on your image. Existing dev boxes will not be modified when an image version is updated.

    Screenshot showing the create dev box definition page with suggested images highlighted.

    While selecting the gallery image, consider using either of the two images:

    • Windows 11 Enterprise + Microsoft 365 Apps 21H2
    • Windows 10 Enterprise + Microsoft 365 Apps 21H2

    These images are preconfigured with productivity tools like Microsoft Teams and configured for optimal performance.

  5. Select Create.

Create a project

The following steps show you how to create and configure a project in dev box.

  1. In the Azure portal, in the search box, type Projects and then select Projects from the list.

  2. On the Projects page, select +Create.

  3. On the Create a project page, on the Basics tab, enter the following values:

    Name Value
    Subscription Select the subscription in which you want to create the project.
    Resource group Select an existing resource group or select Create new, and enter a name for the resource group.
    Dev center Select the dev center to which you want to associate this project. All the dev center level settings will be applied to the project.
    Name Enter a name for your project.
    Description Enter a brief description of the project.

    Screenshot of the Create a dev box project basics tab.

  4. [Optional] On the Tags tab, enter a name and value pair that you want to assign.

  5. Select Review + Create.

  6. On the Review tab, select Create.

  7. Confirm that the project is created successfully by checking the notifications. Select Go to resource.

  8. Verify that you see the Project page.

Next steps

In this quickstart, you created a dev box project and the resources necessary to support it. You created a dev center, added a network connection, created a dev box definition, and a project.

To learn about how to manage dev box projects, advance to the next quickstart: