Create reusable dev box customizations with Dev Home Preview

In this article, you learn how to use Dev Home Preview to create, customize, and connect to your dev box. Dev Home is a Windows application that helps you manage and interact with your dev boxes.

Important

Microsoft Dev Home is currently in PREVIEW. This information relates to a prerelease product that may be substantially modified before it's released. Microsoft makes no warranties, expressed or implied, with respect to the information provided here.

Prerequisites

To complete the steps in this article, you must:

Install or update Dev Home

Dev Home is available in the Microsoft Store. To install or update Dev Home, go to the Dev Home (Preview) page in the Microsoft Store and select Get or Update.

You might also see Dev Home in the Start menu. If you see it there, you can select it to open the app.

Add extensions

Dev Home uses extensions to provide more functionality. To support the Dev Box features, you need to install the Dev Home Azure Extension.

To add an extension:

  1. Open Dev Home.
  2. From the left menu, select Extensions, then in the list of extensions Available in the Microsoft Store, on the Dev Home Azure Extension (Preview), select Get.

Create a dev box

Dev Home provides a guided way for you to create a new dev box.

Note

Dev Home uses the term Environments to refer to all local and cloud virtual machines.

To create a new dev box:

  1. Open Dev Home.

  2. From the left menu, select Environments, and then select Create Environment.

    Screenshot of Dev Home, showing the Environments page with Create Environment highlighted.

  3. On the Select environment page, select Microsoft DevBox, and then select Next.

    Screenshot of Dev Home, showing the Select environment page with Microsoft Dev Box highlighted.

  4. On the Configure your environment page:

    • Enter a name for your dev box.

    • Select the Project you want to create the dev box in.

    • Select the DevBox Pool where you want to create the dev box. Select a pool located close to you to reduce latency.

    • Select Next.

      Screenshot showing the Configure your environment page.

  5. On the Review your environment page, review the details and select Create environment.

  6. Select Go to Environments to see the status of your dev box.

Connect to your dev box

Dev Home provides a seamless way for you to use the Windows App to connect to your Dev Box from any device of your choice. You can customize the look and feel of the Windows App to suit the way you work, and switch between multiple services across accounts.

If the Windows App isn't installed, selecting Launch takes you to the web client to launch the Dev Box. Dev Home provides a way to launch your dev box straight from the app.

Install the Windows App

  1. Go to the Microsoft store and search for Windows App or use this download link:.
  2. Download the app and install it.

Launch your dev box

  1. Open Dev Home.

  2. From the left menu, select Environments.

  3. Select the dev box you want to launch.

  4. Select Launch.

    Screenshot showing a dev box with the Launch menu highlighted.

  5. You can also start and stop the dev box from the Launch menu.

    Screenshot of the Launch menu with Start and Stop options.

For more information on the Windows App, see Windows App.

Access your dev box from the start menu or task bar

Dev home enables you to pin your dev box to the start menu or task bar.

  1. Open Dev Home.

  2. From the left menu, select Environments.

  3. Select the dev box you want to pin or unpin.

  4. Select Pin to start or Pin to taskbar.

    Screenshot showing a dev box with the Pin to start and Pin to taskbar options highlighted.

Customize an existing dev box

Dev home gives you the opportunity to clone repositories and add software to your existing dev box. Dev home uses the Winget catalog to provide a list of software that you can install on your dev box.

  1. Open Dev Home.

  2. From the left menu, select Machine configuration, and then select Set up an environment.

  3. Select the environment you want to customize, and then select Next.

  4. On the Set up an environment page, if you want to clone a repository to your dev box, select Add repository.

  5. In the Add repository dialog, enter the source and destination paths for the repository you want to clone, and then select Add.

    Screenshot showing the Add repository dialog box.

  6. When you finish adding repositories, select Next.

  7. From the list of application Winget provides, choose the software you want to install on your dev box, and then select Next. You can also search for software by name.

    Screenshot showing the Add software page.

  8. On the Review and finish page, under See details:

    1. Select the Environment tab to see the virtual machine you're configuring.
    2. Select the Applications tab to see a list of the software you're installing.
    3. Select the Repositories tab to see the list of public GitHub repositories you're cloning
  9. Select I agree and want to continue, and then select Set up.

You can also generate a configuration file based on your selected repositories and software to use in the future to create dev boxes with the same customizations.