You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
description: Learn how to restore your dev box from a snapshot in Microsoft Dev Box to recover from critical issues. Restore your dev box quickly and efficiently.
2
+
title: Recover Your Dev Box with Snapshots
3
+
description: Learn how Dev Box uses manual and automatic snapshots to enable you to recover your dev box from critical issues. Restore your dev box quickly and efficiently.
4
+
#customer intent: As a developer, I want to restore my dev box from a snapshot so that I can perform testing, or quickly recover from critical issues.
4
5
author: RoseHJM
5
6
ms.author: rosemalcolm
6
7
ms.service: dev-box
7
8
ms.topic: article
8
-
ms.date: 04/29/2025
9
-
10
-
#customer intent: As a developer, I want to restore my dev box from a snapshot so that I can perform testing, or quickly recover from critical issues.
9
+
ms.date: 05/11/2025
10
+
ms.custom:
11
+
- ai-gen-docs-bap
12
+
- ai-gen-title
13
+
- ai-seo-date:05/11/2025
11
14
---
12
15
13
16
# Restore your dev box from a snapshot
@@ -28,34 +31,45 @@ Dev Box automatically takes snapshots, retains them for each dev box, and overwr
28
31
29
32
## How does Dev Box manage snapshots?
30
33
31
-
Microsoft Dev Box automatically takes short snapshots every 12 hours and long snapshots every 7 days. It retains snapshots for 28 days on a rotating basis, overwriting the oldest snapshot when necessary.
34
+
Microsoft Dev Box helps you recover from critical issues by using snapshots that allow you to revert to a previous state if needed. Snapshots are point-in-time copies of your dev box. If something goes wrong, you can restore your dev box to a known good state without losing progress or spending time troubleshooting the issue.
32
35
33
-
The retention period includes 10 short snapshots and 4 long snapshots, totaling 14 snapshots over 28 days. Once the maximum number of snapshots is reached, the oldest one will be deleted. Short snapshots and long snapshots operate independently.
36
+
### Manual snapshots
34
37
35
-
## Restore your dev box from a snapshot
38
+
Take manual snapshots of your dev box to create restore points before making significant changes to your dev box, such as installing new software or making configuration changes. You can use manual snapshots in addition to the automatic snapshots taken by Microsoft Dev Box.
39
+
40
+
### Automatic snapshots
41
+
42
+
Microsoft Dev Box automatically takes short snapshots every 12 hours and long snapshots every seven days. It retains snapshots for 28 days on a rotating basis, overwriting the oldest snapshot when necessary.
43
+
44
+
The retention period includes 10 short snapshots and 4 long snapshots, totaling 14 snapshots over 28 days. Once the maximum number of snapshots is reached, the oldest one is deleted. Short snapshots and long snapshots operate independently.
45
+
46
+
## Take a manual snapshot of your dev box
36
47
37
48
1. Sign in to the [developer portal](https://aka.ms/devbox-portal).
49
+
1. On the dev box that you want to take a snapshot of, select the actions menu, and then select **Take snapshot**.
50
+
:::image type="content" source="media/how-to-restore-from-snapshot/dev-box-actions-menu-snapshot.png" alt-text="Screenshot of the developer portal, showing the actions menu for a dev box with the Take snapshot option highlighted.":::
51
+
1. Select **Take snapshot** to confirm.
52
+
:::image type="content" source="media/how-to-restore-from-snapshot/dev-box-confirm-snapshot.png" alt-text="Screenshot of the developer portal, showing the Take snapshot dialog box with Yes, I want to take a snapshot of this dev box highlighted.":::
53
+
1. The dev box tile displays the progress of the snapshot operation in the developer portal, showing the message **Taking snapshot**.
54
+
:::image type="content" source="media/how-to-restore-from-snapshot/dev-box-snapshot-progress.png" alt-text="Screenshot of the developer portal, showing a dev box tile with the message Taking snapshot.":::
55
+
1. When the snapshot process is complete, the dev box tile displays the message **Snapshot successful**.
56
+
:::image type="content" source="media/how-to-restore-from-snapshot/dev-box-snapshot-successful.png" alt-text="Screenshot of the developer portal, showing a dev box tile with the message Snapshot created.":::
38
57
39
-
1. On the dev box that you want to restore, select the actions menu, and then select **Restore**.
58
+
## Restore your dev box from a snapshot
40
59
60
+
1. Sign in to the [developer portal](https://aka.ms/devbox-portal).
61
+
1. On the dev box that you want to restore, select the actions menu, and then select **Restore**.
41
62
:::image type="content" source="media/how-to-restore-from-snapshot/dev-box-actions-menu-restore.png" alt-text="Screenshot of the developer portal, showing the actions menu for a dev box with the Restore option highlighted.":::
42
-
43
63
1. Read the information about the effect of restoring your dev box. The restore process deletes data and apps added since the chosen snapshot. The restore process can take hours. Select **Yes, I want to restore this dev box** to confirm.
44
-
45
64
:::image type="content" source="media/how-to-restore-from-snapshot/dev-box-confirm-restore.png" alt-text="Screenshot of the developer portal, showing the Restore dialog box with the Restore to list highlighted.":::
46
-
47
-
1. Select the desired restore point from the list of available snapshots.
48
-
65
+
1. Select the desired restore point from the list of available snapshots. **Manual snapshots** are listed first, followed by **Automatic snapshots**. The most recent snapshot is at the top of the list.
66
+
:::image type="content" source="media/how-to-restore-from-snapshot/dev-box-snapshot-list.png" alt-text="Screenshot of the developer portal, showing the list of manual and automatic snapshots available to restore.":::
67
+
1. Verify that the snapshot you want to restore from is selected, and then select **Restore**.
49
68
:::image type="content" source="media/how-to-restore-from-snapshot/dev-box-select-restore-point.png" alt-text="Screenshot of the developer portal, showing the Restore dialog box with Yes, I want to restore this dev box highlighted.":::
50
-
51
69
1. You can check the progress of the restore operation on the dev box tile in the developer portal.
52
-
53
70
:::image type="content" source="media/how-to-restore-from-snapshot/dev-box-restore-progress.png" alt-text="Screenshot of the developer portal, showing a dev box tile with the message Restoring dev box.":::
54
-
55
71
1. When the restoration is complete, you receive an email notification that your dev box is restored and ready to use.
56
72
57
-
:::image type="content" source="media/how-to-restore-from-snapshot/dev-box-restore-email.png" alt-text="Screenshot of an email notification informing you that your dev box is restored and ready to use.":::
58
-
59
73
## Related content
60
74
61
75
-[Manage a dev box by using the Microsoft Dev Box developer portal](how-to-create-dev-boxes-developer-portal.md)
0 commit comments