How to Checkpoint a MicroVM
Last verified 17 Nov 2026
DigitalOcean MicroVMs are lightweight virtual machines that run a container image in an isolated kernel, pause automatically when idle, and resume on the next request with memory, files, and processes intact.
A DigitalOcean MicroVM checkpoint captures a MicroVM’s memory and disk. New MicroVMs created from the checkpoint start from that state and inherit its region, size, image, environment variables, and outbound policy. For what a new MicroVM inherits and the checkpoint statuses, see MicroVM Checkpoints.
You can create a checkpoint of a running or paused MicroVM.
Checkpoint a MicroVM Using the Control Panel
Go to the MicroVMs page, select the MicroVM, click the Checkpoints tab, then click Create Checkpoint. You can also open the MicroVM’s menu on the MicroVMs page and click Create a checkpoint. The capture runs in the background, and the checkpoint appears on the Checkpoints tab when it is ready.
To create a MicroVM from the checkpoint, click Create MicroVM in the checkpoint’s row on the Checkpoints tab. You can also go to the Create MicroVM page, open Checkpoints under Choose an image, and select the checkpoint. The region, size, and outbound policy come from the checkpoint. Complete the remaining settings as described in How to Create a MicroVM.
To delete a checkpoint, open its menu on the Checkpoints tab and click Delete, then confirm in the Delete checkpoint window. You can no longer create MicroVMs from a deleted checkpoint.
Checkpoint a MicroVM Using doctl
Create a checkpoint. --name is optional.
List a MicroVM’s checkpoints, newest first, with doctl compute microvm checkpoint list and its --microvm-id flag.
Check whether a checkpoint is ready with doctl compute microvm checkpoint get. It is ready when its status is CHECKPOINT_AVAILABLE.
Create a MicroVM from the checkpoint. The region, size, image, and environment variables come from the checkpoint:
doctl compute microvm create example-from-checkpoint \
--checkpoint-id <your-checkpoint-id>Delete the checkpoint. The command prompts for confirmation, and --force skips the prompt.
You cannot delete a checkpoint while it is still being captured.
Checkpoint a MicroVM Using the API
Send a POST request to /v2/microvms/<your-microvm-id>/checkpoints to create a checkpoint. name is optional.
Poll the checkpoint with a GET request to /v2/microvms/checkpoints/<your-checkpoint-id> until status is CHECKPOINT_AVAILABLE.
To list a MicroVM’s checkpoints, newest first, send a GET request to /v2/microvms/checkpoints with the microvm_id query parameter.
Create a MicroVM from a Checkpoint Using the API
Send a POST request to /v2/microvms with source.checkpoint_id set to the checkpoint’s ID. Omit region, size, and environment, which come from the checkpoint:
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
-d '{
"name": "example-from-checkpoint",
"source": {"checkpoint_id": "<your-checkpoint-id>"}
}' \
"https://api.digitalocean.com/v2/microvms"The request usually returns with the new MicroVM already running.
Delete a Checkpoint Using the API
Send a DELETE request to /v2/microvms/checkpoints/<your-checkpoint-id>.
The request returns HTTP 400 while the checkpoint is still being captured.