Manage a dev box by using the Microsoft Dev Box developer portal
In this article, you learn how to manage a dev box by using the Microsoft Dev Box developer portal. Developers can access their dev boxes directly in the developer portal, instead of having to use the Azure portal.
As a developer, you can view information about your dev boxes. You can also connect to, start, stop, restart, and delete them.
Permissions
As a dev box developer, you can:
- Create, view, and delete dev boxes that you create.
- View pools within a project.
- Connect to dev boxes.
Create a dev box
You can create as many dev boxes as you need through the Microsoft Dev Box developer portal. You might create a separate dev box for different scenarios, for example:
- Dev box per workload. Create a dev box for your front-end work and a separate dev box for your back-end work. You can also create multiple dev boxes for your back-end system.
- Dev box for bug fixing. Use a separate dev box for the bug fix to work on the specific task and troubleshoot the issue without impacting your primary machine.
You can create a dev box by using the Microsoft Dev Box developer portal. For more information, see Quickstart: Create a dev box by using the developer portal.
You can also create a dev box through the Azure CLI dev center extension. For more information, see Configure Microsoft Dev Box from the command-line with the Azure CLI.
Connect to a dev box
After you create your dev box, you can connect to it through a Remote Desktop application or via the browser.
The new Windows App remote desktop client is the recommended client for Microsoft Dev Box; it provides an enhanced user experience, including support for multiple monitors. It is also available on multiple platforms, including Windows, macOS, iOS/iPadOS, Android/Chrome OS (preview), and web browsers. For more information, see Get started with Windows App.
You can use the browser for lighter workloads. When you access your dev box via your phone or laptop, you can use the browser. The browser is useful for tasks such as a quick bug fix or a review of a GitHub pull request. For more information, see the steps for using a browser to connect to a dev box.
Shut down, restart, or start a dev box
You can perform many actions on a dev box in the Microsoft Dev Box developer portal by using the actions menu (...) on the dev box tile. The available options depend on the state of the dev box and the configuration of the dev box pool it belongs to. For example, you can shut down or restart a running dev box, or start a stopped dev box.
To shut down or restart a dev box:
Sign in to the developer portal.
On the dev box you that want to shut down or restart, select the actions menu (...).
For a running dev box, you can select Shut down or Restart.
To start a dev box:
Sign in to the developer portal.
On the dev box you that want to start, select the actions menu (...).
For a stopped dev box, you can select Start.
Get information about a dev box
You can use the Microsoft Dev Box developer portal to view information about a dev box, such as the creation date, and the dev center and dev box pool it belongs to. You can also check the source image in use.
To get more information about your dev box:
Sign in to the developer portal.
On the dev box that you want to view, select the actions menu (...) and then select More Info.
In the dev box details pane, you see more information about your dev box, like the following example:
Delete a dev box
When you no longer need a dev box, you can delete it in the developer portal.
There are many reasons why you might not need a dev box anymore. Maybe you completed your testing, or you finished working on a specific project within your product.
You can delete dev boxes after you finish your tasks. Suppose you finish fixing your bug and merge your pull request. Now, you can delete your dev box and create new dev boxes to work on new items.
Important
You can't retrieve a dev box after it's deleted. Before you delete a dev box, confirm that neither you nor your team members need the dev box for future tasks.
Sign in to the developer portal.
For the dev box that you want to delete, select the actions menu (...) and then select Delete.
To confirm the deletion, select Delete.
