Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
---
title: Larger Container instance types
description: New Container instance types provide more resources for your container applications
products:
- containers
date: 2025-10-01
---

New instance types provide up to 4 vCPU, 12 GiB of memory, and 20 GB of disk per container instance.

| Instance Type | vCPU | Memory | Disk |
| ------------- | ---- | ------ | ---- |
| lite | 1/16 | 256 MiB | 2 GB |
| basic | 1/4 | 1 GiB | 4 GB |
| standard-1 | 1/2 | 4 GiB | 8 GB |
| standard-2 | 1 | 6 GiB | 12 GB |
| standard-3 | 2 | 8 GiB | 16 GB |
| standard-4 | 4 | 12 GiB | 20 GB |

The `dev` and `standard` instance types are preserved for backward compatibility and are aliases for `lite` and `standard-1`, respectively. The `standard-1` instance type now provides up to 8 GB of disk instead of only 4 GB.

See the [getting started guide](/containers/get-started/) to deploy your first Container,
and the [limits documentation](/containers/platform-details/limits/) for more details on the available instance types and limits.
21 changes: 14 additions & 7 deletions src/content/docs/containers/platform-details/limits.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -8,16 +8,23 @@ sidebar:
## Instance Types

The memory, vCPU, and disk space for Containers are set through predefined instance types.
Three instance types are currently available:
Six instance types are currently available:

| Instance Type | Memory | vCPU | Disk |
| ------------- | ------- | ---- | ---- |
| dev | 256 MiB | 1/16 | 2 GB |
| basic | 1 GiB | 1/4 | 4 GB |
| standard | 4 GiB | 1/2 | 4 GB |
| Instance Type | vCPU | Memory | Disk |
| ------------- | ---- | ------ | ---- |
| lite | 1/16 | 256 MiB | 2 GB |
| basic | 1/4 | 1 GiB | 4 GB |
| standard-1 | 1/2 | 4 GiB | 8 GB |
| standard-2 | 1 | 6 GiB | 12 GB |
| standard-3 | 2 | 8 GiB | 16 GB |
| standard-4 | 4 | 12 GiB | 20 GB |

These are specified using the [`instance_type` property](/workers/wrangler/configuration/#containers) in your Worker's Wrangler configuration file. Looking for larger instances? [Give us feedback here](/containers/beta-info/#feedback-wanted) and tell us what size instances you need, and what you want to use them for.

:::note
The `dev` and `standard` instance types are preserved for backward compatibility and are aliases for `lite` and `standard-1`, respectively.
:::

## Limits

While in open beta, the following limits are currently in effect:
Expand All @@ -30,4 +37,4 @@ While in open beta, the following limits are currently in effect:
| Image size | Same as [instance disk space](#instance-types) |
| Total image storage per account | 50 GB [^1] |

[^1]: Delete container images with `wrangler containers delete` to free up space. Note that if you delete a container image and then [roll back](/workers/configuration/versions-and-deployments/rollbacks/) your Worker to a previous version, this version may no longer work.
[^1]: Delete container images with `wrangler containers delete` to free up space. Note that if you delete a container image and then [roll back](/workers/configuration/versions-and-deployments/rollbacks/) your Worker to a previous version, this version may no longer work.
8 changes: 4 additions & 4 deletions src/content/docs/workers/wrangler/configuration.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -986,7 +986,7 @@ The following options are available:

- `instance_type` <Type text="string" /> <MetaInfo text="optional" />
- The instance type of the container. This determines the amount of memory, CPU, and disk given to the container
instance. The current options are `"dev"`, `"basic"`, and `"standard"`. The default is `"dev"`. For more information,
instance. The current options are `"lite"`, `"basic"`, `"standard-1"`, `"standard-2"`, `"standard-3"`, and `"standard-4"`. The default is `"lite"`. For more information,
the see [instance types documentation](/containers/platform-details#instance-types).

- To specify a custom instance type, see [here](#custom-instance-types).
Expand All @@ -996,7 +996,7 @@ The following options are available:
request to run a container than this number, the container request will error. You may have more Durable Objects
than this number over a longer time period, but you may not have more concurrently.

- Defaults to 1.
- Defaults to 1.

- This value is only enforced when running in production on Cloudflare's network. This limit does not apply during local development, so you may run more instances than specified.

Expand Down Expand Up @@ -1028,7 +1028,7 @@ The following options are available:
class_name = "MyContainer"
image = "./Dockerfile"
max_instances = 10
instance_type = "basic" # Optional, defaults to "dev"
instance_type = "basic" # Optional, defaults to "lite"
image_vars = { FOO = "BAR" }

[[durable_objects.bindings]]
Expand Down Expand Up @@ -1433,4 +1433,4 @@ A common example of using a redirected configuration is where a custom build too
{
"configPath": "../../dist/wrangler.jsonc"
}
```
```
Loading