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,22 @@
---
title: Custom container instance types now available for all users
description: Configure custom vCPU, memory, and disk allocations for your container instances
products:
- containers
date: 2026-01-05
---

Custom instance types are now enabled for all [Cloudflare Containers](/containers) users. You can now specify specific vCPU, memory, and disk amounts, rather than being limited to pre-defined [instance types](/containers/platform-details/limits/#instance-types). Previously, only select Enterprise customers were able to customize their instance type.

To use a custom instance type, specify the `instance_type` property as an object with `vcpu`, `memory_mib`, and `disk_mb` fields in your Wrangler configuration:

```toml
[[containers]]
image = "./Dockerfile"
instance_type = { vcpu = 2, memory_mib = 6144, disk_mb = 12000 }
```

Individual limits for custom instance types are based on the `standard-4` instance type (4 vCPU, 12 GiB memory, 20 GB disk). You must allocate at least 1 vCPU for custom instance types. For workloads requiring less than 1 vCPU, use the predefined instance types like `lite` or `basic`.

See the [limits documentation](/containers/platform-details/limits/#custom-instance-types) for the full list of constraints on custom instance types.
See the [getting started guide](/containers/get-started/) to deploy your first Container,
21 changes: 20 additions & 1 deletion src/content/docs/containers/platform-details/limits.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -14,12 +14,31 @@ Six instance types are currently available:

<Render product="containers" file="instance-types" />

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.
These are specified using the [`instance_type` property](/workers/wrangler/configuration/#containers) in your Worker's Wrangler configuration file.

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

### Custom Instance Types

In addition to the predefined instance types, you can configure custom instance types by specifying `vcpu`, `memory_mib`, and `disk_mb` values. See the [Wrangler configuration documentation](/workers/wrangler/configuration/#custom-instance-types) for configuration details.

Custom instance types have the following constraints:

| Resource | Limit |
| -------------------- | ----------------------------------- |
| Minimum vCPU | 1 |
| Maximum vCPU | 4 |
| Maximum Memory | 12 GiB |
| Maximum Disk | 20 GB |
| Memory to vCPU ratio | Minimum 3 GiB memory per vCPU |
| Disk to Memory ratio | Maximum 2 GB disk per 1 GiB memory |

For workloads requiring less than 1 vCPU, use the predefined instance types such as `lite` or `basic`.

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.

## Limits

While in open beta, the following limits are currently in effect:
Expand Down
8 changes: 2 additions & 6 deletions src/content/docs/workers/wrangler/configuration.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -1071,12 +1071,8 @@

### Custom Instance Types

:::note
For Enterprise customers only.
:::

In place of the [named instance types](/containers/platform-details#instance-types), you can set a custom instance type by
individually configuring vCPU, memory, and disk.
In place of the [named instance types](/containers/platform-details/limits/#instance-types), you can set a custom instance type by individually configuring vCPU, memory, and disk.
See the [limits documentation](/containers/platform-details/limits/#custom-instance-types) for constraints on custom instance types.

The following options are available:

Expand All @@ -1087,7 +1083,7 @@
- The memory to be used by your container, in MiB. Defaults to `256`.

- `disk_mb` <Type text="number" /> <MetaInfo text="optional" />
- The disk to be used by your container, in MB. Defaults to `2000` (2GB).

Check warning on line 1086 in src/content/docs/workers/wrangler/configuration.mdx

View workflow job for this annotation

GitHub Actions / Semgrep

semgrep.style-guide-potential-date-year

Potential year found. Documentation should strive to represent universal truth, not something time-bound. (add [skip style guide checks] to commit message to skip)

<WranglerConfig>

Expand Down