Skip to content
Cloudflare Docs

Containers

Interact with Containers using Wrangler.

build

Build a Container image from a Dockerfile.

wrangler containers build [PATH] [OPTIONS]
  • PATH string optional
    • Path for the directory containing the Dockerfile to build.
  • -t, --tag string required
    • Name and optionally a tag (format: "name:tag").
  • --path-to-docker string optional
    • Path to your docker binary if it's not on $PATH.
    • Default: "docker"
  • -p, --push boolean optional
    • Push the built image to Cloudflare's managed registry.
    • Default: false

delete

Delete a Container (application).

wrangler containers delete <CONTAINER_ID> [OPTIONS]
  • CONTAINER_ID string required
    • The ID of the Container to delete.

images

Perform operations on images in your containers registry.

images list

List images in your containers registry.

wrangler containers images list [OPTIONS]
  • --filter string optional
    • Regex to filter results.
  • --json boolean optional
    • Return output as clean JSON.
    • Default: false

images delete

Remove an image from your containers registry.

wrangler containers images delete [IMAGE] [OPTIONS]
  • IMAGE string required
    • Image to delete of the form IMAGE:TAG

registries

Configure and view registries available to your container. Read more about our currently supported external registries.

registries list

List registries your containers are able to use.

wrangler containers registries list [OPTIONS]
  • --json boolean optional
    • Return output as clean JSON.
    • Default: false

registries configure

Configure a new registry for your account.

wrangler containers registries configure [DOMAIN] [OPTIONS]
  • DOMAIN string required
    • Domain to configure for the registry.
  • --public-credential string required
    • The public part of the registry credentials, e.g. AWS_ACCESS_KEY_ID for ECR
  • --secret-store-id string optional
    • The ID of the secret store to use to store the registry credentials
  • --secret-name string optional
    • The name Wrangler should store the registry credentials under

When run interactively, wrangler will prompt you for your secret and store it in Secrets Store. To run non-interactively, you can send your secret value to wrangler through stdin to have the secret created for you.

registries delete

Remove a registry configuration from your account.

wrangler containers registries delete [DOMAIN] [OPTIONS]
  • DOMAIN string required
    • domain of the registry to delete

info

Get information about a specific Container, including top-level details and a list of instances.

wrangler containers info <CONTAINER_ID> [OPTIONS]
  • CONTAINER_ID string required
    • The ID of the Container to get information about.

instances

List all Container instances for a given application. Displays instance ID, name, state, location, version, and creation time.

In interactive mode, results are paginated. Press Enter to load the next page or Esc/q to stop. In non-interactive environments (for example, when piping output or running in CI), all pages are fetched automatically.

Use the --json flag to return output as a flat JSON array. Each element contains the fields id, name, state, location, version, and created. This is also the default output format in non-interactive environments.

wrangler containers instances <APPLICATION_ID> [OPTIONS]
  • APPLICATION_ID string required
    • The UUID of the application to list instances for. Use wrangler containers list to find application IDs.
  • --per-page number optional
    • Number of instances per page.
    • Default: 25
  • --json boolean optional
    • Return output as clean JSON.
    • Default: false

For example, to list instances for an application:

Terminal window
wrangler containers instances 12345678-abcd-1234-abcd-123456789abc
INSTANCE                              NAME        STATE          LOCATION  VERSION  CREATED
a1b2c3d4-e5f6-7890-abcd-ef1234567890  worker-12   running        sfo06     3        2025-06-01T12:00:00Z
b2c3d4e5-f6a7-8901-bcde-f12345678901  worker-47   provisioning   iad01     2        2025-06-01T13:00:00Z

To get the same data as JSON:

Terminal window
wrangler containers instances 12345678-abcd-1234-abcd-123456789abc --json
[
  {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "name": "worker-12",
    "state": "running",
    "location": "sfo06",
    "version": 3,
    "created": "2025-06-01T12:00:00Z"
  }
]

list

List the Containers in your account.

wrangler containers list [OPTIONS]

push

Push a tagged image to a Cloudflare managed registry, which is automatically integrated with your account.

wrangler containers push [TAG] [OPTIONS]
  • TAG string required
    • The name and tag of the container image to push.
  • --path-to-docker string optional
    • Path to your docker binary if it's not on $PATH.
    • Default: "docker"

ssh

Connect to a running Container instance using SSH. Refer to SSH for configuration details.

wrangler containers ssh <INSTANCE_ID>

You can also specify a command to run, instead of the default shell. For example:

wrangler containers ssh <INSTANCE_ID> -- ls -al
  • INSTANCE_ID string required
    • The ID of the Container instance to SSH into.