Key details

  1. The `durable_object` scheduling policy entered public beta on September 30, 2026.
  2. A Durable Object can select the Container image and instance size at runtime.
  3. Durable Object-managed instances have independent lifecycles and do not join application-wide image rollouts.
  4. Cloudflare provides a managed `cloudflare/debian-trixie` image with Node.js 24.20.0.
  5. Filesystem snapshots are available only with the `durable_object` scheduling policy.
  6. Snapshots capture the complete filesystem but not memory or running processes.
  7. Snapshots are immutable and tied to the image version from which they were created.

What builders should take away

  1. Agent and sandbox platforms can assign different runtime images or sizes per stateful Durable Object instead of treating every Container as one deployment cohort.
  2. Use snapshots for disk-state checkpoints, not process checkpointing; application code must recreate in-memory state after restore.
  3. Plan image migrations deliberately because a snapshot is not portable across image versions and independently managed instances do not automatically follow application-wide rollouts.
  4. Treat the feature as public beta and test lifecycle, recovery and billing behaviour before relying on it for critical production state.

What changed

On September 30, 2026 Cloudflare introduced the `durable_object` scheduling policy for Containers in public beta. Instead of a centrally configured image and instance type for an application, a Durable Object can select an immutable image reference and instance size when it starts a Container. Cloudflare also documented filesystem snapshots for Containers using this policy, allowing point-in-time filesystem state to be captured and restored later.

Why it matters

This gives builders a more stateful, individually addressable compute model inside Cloudflare's platform. Agent sandboxes, development environments and other long-lived workloads can choose runtime resources per instance and preserve disk state without coupling every instance to an application-wide image rollout. It narrows the gap between serverless orchestration and VM-like lifecycle control, while retaining important constraints around image compatibility and snapshot scope.

A Durable Object can now decide what Container to run

With the new scheduling policy, Wrangler prepares configured images and exposes immutable references through the Durable Object Container API. The Durable Object supplies the image and instance size when starting the Container. Cloudflare also provides a managed Debian Trixie image with Node.js 24.20.0 that can be started without defining a custom image.

Instances stop participating in one application-wide rollout

Cloudflare says Durable Object-managed Container instances have independent lifecycles and do not participate in application-wide image rollouts. That gives an application more control over when individual stateful workloads move between images or sizes, but it also means builders need an explicit update strategy for those instances.

Snapshots preserve disk state, not a running process

Snapshots capture the Container's complete filesystem state but not memory or running processes. They are immutable and tied to the Container image version that created them. A snapshot cannot be restored onto a different image version, and applications must use the durable_object scheduling policy to create or restore one.

What to watch next

  • Pricing and retention details for filesystem snapshots.
  • Whether Cloudflare expands snapshots beyond the durable_object scheduling policy.
  • How image upgrades and fleet management evolve for independently managed Container instances.
  • Production evidence from agent sandboxes, development environments and other stateful workloads using the new lifecycle model.

Still unclear

  • The scheduling policy is public beta, so APIs and operational limits can still change.
  • The current snapshot documentation does not establish VM-style memory/process checkpointing; only filesystem state is captured.
  • Independent production performance and recovery measurements are not yet available.

Sources

Direct reading behind this dossier.

2 sources
Use snapshots
Cloudflare Docs primary documentation

Primary documentation for filesystem snapshot scope, policy requirement, immutability and image-version compatibility.

Discussion

Discussion is reader-contributed. Comments are not part of the BTN dossier or its editorial evidence.

0 visible comments

Join the discussion

Keep comments useful and relevant. Reader contributions may be moderated and are not BTN editorial evidence.

Sign in to comment