Wrangler configuration

Last updated Oct 12, 2026 Define Containers in the Wrangler configuration file for your Worker. Each Container is associated with a Durable Object class, which provides access to the Container at runtime.

Minimal configuration

A new Container application requires a Container definition, a Durable Object binding, and a Durable Object class export:

{
    "$schema": "./node_modules/wrangler/config-schema.json",
    "name": "my-container-worker",
    "main": "src/index.ts",
    "upload_source_maps": true,
    // Set this to today's date
    "compatibility_date": "2026-10-27",
    "containers": [
        {
            "class_name": "MyContainer",
            "image": "./Dockerfile",
            "max_instances": 10,
        },
    ],
    "durable_objects": {
        "bindings": [
            {
                "name": "MY_CONTAINER",
                "class_name": "MyContainer",
            },
        ],
    },
    "exports": {
        "MyContainer": {
            "type": "durable-object",
            "storage": "sqlite",
        },
    },
}

"$schema" = "./node_modules/wrangler/config-schema.json"
name = "my-container-worker"
main = "src/index.ts"
upload_source_maps = true
# Set this to today's date
compatibility_date = "2026-10-27"

[[containers]]
class_name = "MyContainer"
image = "./Dockerfile"
max_instances = 10

[[durable_objects.bindings]]
name = "MY_CONTAINER"
class_name = "MyContainer"

[exports.MyContainer]
type = "durable-object"
storage = "sqlite"

The configuration uses three sections:

  1. containers defines the container image and associates it with a Durable Object class through class_name.
  2. durable_objects.bindings makes the Durable Object namespace available to Worker code. In this example, access it through env.MY_CONTAINER.
  3. exports declares the Durable Object class and provisions it with SQLite storage.

The class_name in containers and durable_objects.bindings, and the key in exports, must match the exported Durable Object class in your Worker.

Existing applications

Existing applications that use the legacy migrations array can continue to use it. Do not configure exports and migrations together. To switch an existing application to exports, refer to Migrate from the legacy migrations flow.

Container settings

The containers entry can also configure the instance type, maximum number of running instances, image build, placement constraints, rollouts, and SSH access.

For all available fields and values, refer to the Containers Wrangler configuration reference.

Next steps

Was this helpful?

YesNo

On this page

Wrangler configuration - 图1Docs

{"@context":"https://schema.org","@type":"TechArticle","@id":"https://developers.cloudflare.com/containers/configuration/wrangler/#page","headline":"Wrangler configuration","description":"Configure a Container, its Durable Object binding, and its class export in Wrangler.","url":"https://developers.cloudflare.com/containers/configuration/wrangler/","inLanguage":"en","image":"https://developers.cloudflare.com/containers/configuration/wrangler/og.png?v=2a187101b50ae69b","dateModified":"2026-10-12","publisher":{"@type":"Organization","name":"Cloudflare","description":"One platform for your apps, agents, and workforce. Build, secure, and scale without managing infrastructure","url":"https://www.cloudflare.com/","sameAs":["https://github.com/cloudflare","https://www.linkedin.com/company/cloudflare","https://x.com/cloudflare"],"logo":{"@type":"ImageObject","url":"https://developers.cloudflare.com/logo.svg"},"address":{"@type":"PostalAddress","streetAddress":"101 Townsend St","addressLocality":"San Francisco","addressRegion":"CA","postalCode":"94107","addressCountry":"US"},"contactPoint":[{"@type":"ContactPoint","contactType":"Customer Support","url":"https://support.cloudflare.com/","availableLanguage":["English"]},{"@type":"ContactPoint","contactType":"Sales","url":"https://www.cloudflare.com/contact/","availableLanguage":["English"]}]},"isPartOf":{"@type":"WebSite","@id":"https://developers.cloudflare.com/#website","name":"Cloudflare Docs","url":"https://developers.cloudflare.com/"}}

description: Use the Durable Object Container API for new applications and compare it with the Container class. title: API image: https://developers.cloudflare.com/containers/api/og.png?v=b5325a11e1e8cc4d

Skip to content

Documentation Index
Fetch the complete documentation index at: https://developers.cloudflare.com/containers/llms.txt
Use this file to discover all available pages before exploring further.