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 thedeveloper portal.

2. On the dev box you want to hibernate, on the actions menu, selectHibernate. Dev boxes that don't support hibernation show only theShutdown option.

   

3. Confirm that you want to hibernate your 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 thedeveloper portal.

2. On the dev box you want to resume, on the actions menu, selectResume.

   

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:

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.

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 thedeveloper portal, select your DevBox, and on the actions menu, selectShut 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.

Related content

• Manage a dev box by using the developer portal
• How to configure Dev Box Hibernation