Checkpoints

A checkpoint is a point-in-time capture of a runtime’s state, writable filesystem changes, and restore metadata such as vCPU, memory, CPU architecture, and pinned image hashes.

Create a Checkpoint

CLI

runta checkpoint create demo demo-checkpoint

Python

from runta import Runta

runta = Runta()
runtime = runta.runtimes.get("demo")

checkpoint = runtime.checkpoints.create(name="demo-checkpoint")

TypeScript

import { Runta } from "@runta/runta-sdk";

const runta = new Runta();
const runtime = await runta.runtimes.get("demo");

const checkpoint = await runtime.checkpoints.create("full", "demo-checkpoint");

List and Inspect

CLI

runta checkpoint ls
runta checkpoint ls --all

Python

for checkpoint in runta.checkpoints.list(include_system=True):
    print(checkpoint.id, checkpoint.display_name, checkpoint.state)

TypeScript

for (const checkpoint of await runta.checkpoints.list({ includeSystem: true })) {
  console.log(checkpoint.id, checkpoint.displayName, checkpoint.state);
}

Restore

Restoring a checkpoint creates a new runtime.

CLI

runta checkpoint restore demo-checkpoint restored-demo
runta checkpoint restore demo-checkpoint restored-demo --publish 8080/https

Python

restored = runta.runtimes.create(
    "restored-demo",
    checkpoint_id=checkpoint.id,
)

TypeScript

const restored = await runtime.restore(checkpoint.id, {
  name: "restored-demo",
});

You can restore the same checkpoint more than once to fork multiple runtimes from the same captured state.

Delete

CLI

runta checkpoint rm demo-checkpoint

Python

runta.checkpoints.delete(checkpoint.id)

TypeScript

await runta.checkpoints.delete(checkpoint.id);

Quick Reference

CLI

Use the Runta CLI for terminal workflows, shell scripts, and direct runtime operations.

Task	CLI command
Create a checkpoint	runta checkpoint create demo demo-checkpoint
List checkpoints	runta checkpoint ls --all
Restore into a new runtime	runta checkpoint restore demo-checkpoint restored-demo
Delete a checkpoint	runta checkpoint rm demo-checkpoint

Python

Use these calls after creating or resolving a Python runtime handle such as runtime.

Task	Python SDK
Create a checkpoint	runtime.checkpoints.create(name="demo-checkpoint")
List checkpoints	runta.checkpoints.list(include_system=True)
Restore into a new runtime	runta.runtimes.create("restored-demo", checkpoint_id=checkpoint.id)
Delete a checkpoint	runta.checkpoints.delete(checkpoint.id)

TypeScript

Use these promise-based calls after creating or resolving a TypeScript runtime handle.

Task	TypeScript SDK
Create a checkpoint	await runtime.checkpoints.create("full", "demo-checkpoint")
List checkpoints	await runta.checkpoints.list({ includeSystem: true })
Restore into a new runtime	await runtime.restore(checkpoint.id, { name: "restored-demo" })
Delete a checkpoint	await runta.checkpoints.delete(checkpoint.id)