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.

How to Create a Checkpoint of a MicroVM Using the DigitalOcean CLI
  1. Install doctl, the official DigitalOcean CLI.
  2. Create a personal access token and save it for use with doctl.
  3. Use the token to grant doctl access to your DigitalOcean account.
    doctl auth init
  4. Finally, run doctl compute microvm checkpoint create. Basic usage looks like this, but you can read the usage docs for more details:
    doctl compute microvm checkpoint create <microvm-id> [flags]

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.

How to Delete One or More MicroVM Checkpoints Using the DigitalOcean CLI
  1. Install doctl, the official DigitalOcean CLI.
  2. Create a personal access token and save it for use with doctl.
  3. Use the token to grant doctl access to your DigitalOcean account.
    doctl auth init
  4. Finally, run doctl compute microvm checkpoint delete. Basic usage looks like this, but you can read the usage docs for more details:
    doctl compute microvm checkpoint delete <checkpoint-id>... [flags]

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.

How to Create a Checkpoint of a MicroVM Using the DigitalOcean API

Create a personal access token and save it for use with the API.

cURL

Send a POST request to https://api.digitalocean.com/v2/microvms/{microvm_id}/checkpoints.

Using cURL:

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
  -d '{"name": "example-checkpoint"}' \
  "https://api.digitalocean.com/v2/microvms/01a0ef1a-d873-793d-ae6a-5dd6239be62a/checkpoints"

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

How to Delete a Checkpoint Using the DigitalOcean API

Create a personal access token and save it for use with the API.

cURL

Send a DELETE request to https://api.digitalocean.com/v2/microvms/checkpoints/{checkpoint_id}.

Using cURL:

curl -X DELETE \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer $DIGITALOCEAN_TOKEN" \
  "https://api.digitalocean.com/v2/microvms/checkpoints/01a0ed98-0a74-75dd-a625-e4856adbc298"

The request returns HTTP 400 while the checkpoint is still being captured.

We can't find any results for your search.

Try using different keywords or simplifying your search terms.