Proposed Pull Request Change

📄 Document Links

View on GitHub View on Microsoft Learn

--- title: Hibernate a dev box titleSuffix: Microsoft Dev Box description: Learn how to hibernate a dev box in Microsoft Dev Box. Use hibernation to shut down your VM, while preserving your active work. services: dev-box ms.service: dev-box ms.custom: - devx-track-azurecli - build-2025 author: RoseHJM ms.author: rosemalcolm ms.date: 03/20/2025 ms.topic: how-to #Customer intent: As a developer, I want to be able to hibernate my dev boxes so that I can resume work where I left off. --- # Hibernate a dev box in Microsoft Dev Box In this article, you learn how to hibernate and resume a dev box in Microsoft Dev Box. Hibernation is a power-saving state that saves your running applications to your hard disk and then shuts down the virtual machine (VM). When you resume the VM, all your previous work is restored. You can hibernate your dev box through the Microsoft Dev Box developer portal or the CLI. You can't hibernate your dev box from within the virtual machine. ## Hibernate your dev box using the developer portal To hibernate your dev box through the Microsoft Dev Box developer portal: 1. Sign in to the [developer portal](https://aka.ms/devbox-portal). 1. On the dev box you want to hibernate, on the actions menu, select **Hibernate**. Dev boxes that don't support hibernation show only the **Shutdown** option. :::image type="content" source="media/how-to-hibernate-your-dev-box/dev-box-actions-hibernate.png" alt-text="Screenshot of the developer portal, showing a dev box with the actions menu open and the hibernate option highlighted."::: 1. Confirm that you want to hibernate your dev box. :::image type="content" source="media/how-to-hibernate-your-dev-box/dev-box-hibernate-confirm.png" alt-text="Screenshot of the developer portal, showing a confirmation dialog for hibernating a dev box."::: ## Resume your dev box using the developer portal To resume your dev box through the Microsoft Dev Box developer portal: 1. Sign in to the [developer portal](https://aka.ms/devbox-portal). 1. On the dev box you want to resume, on the actions menu, select **Resume**. :::image type="content" source="media/how-to-hibernate-your-dev-box/dev-box-actions-resume.png" alt-text="Screenshot of the developer portal, showing a dev box with the actions menu open and the resume option highlighted."::: In addition, you can also double select on your dev box in the list of VMs you see in the Windows App. Your dev box automatically starts up and resumes from a hibernating state. ## Hibernate your dev box using the Azure CLI To hibernate your dev box by using the Azure CLI: ```azurecli-interactive az devcenter dev dev-box stop --name <YourDevBoxName> --dev-center-name <YourDevCenterName> --project-name <YourProjectName> --user-id "me" --hibernate true ``` To learn more about managing your dev box from the CLI, see: [devcenter reference](/cli/azure/devcenter/dev/dev-box?view=azure-cli-latest&preserve-view=true). ## Troubleshooting **My dev box doesn't resume from hibernated state. Attempts to connect to it fail and I receive an error from the RDP app.** If your machine is unresponsive, it might have stalled either while going into hibernation or resuming from hibernation. To resolve this issue, you can manually reboot your dev box. To shut down your dev box, either - Developer portal - Go to the [developer portal](https://aka.ms/devbox-portal), select your DevBox, and on the actions menu, select **Shut down**. - CLI - `az devcenter dev dev-box stop --name <YourDevBoxName> --dev-center-name <YourDevCenterName> --project-name <YourProjectName> --user-id "me" --hibernate false` **I changed some settings on one of my dev boxes and it no longer hibernates. My other dev boxes hibernate without issues. What could be the problem?** Some settings aren't compatible with hibernation and prevent your dev box from hibernating. To learn about these settings, see: [Settings not compatible with hibernation](how-to-configure-dev-box-hibernation.md#settings-not-compatible-with-hibernation). ## Related content - [Manage a dev box by using the developer portal](how-to-create-dev-boxes-developer-portal.md) - [How to configure Dev Box Hibernation](how-to-configure-dev-box-hibernation.md)