> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bead.run/llms.txt
> Use this file to discover all available pages before exploring further.

# Sandbox machine sizes

> Compare sandbox machine sizes to choose CPU, memory, and disk limits and check current availability.

Choose from sandbox machine sizes when you create a machine. Size selects CPU, memory, and disk capacity independently of the disk template. The default is `medium`.

| Size | vCPU | Memory (GiB) | Usable disk (GiB) |
| - | -: | -: | -: |
| `xs` | 1 | 2 | 20 |
| `small` | 2 | 4 | 40 |
| `medium` | 4 | 8 | 40 |
| `large` | 8 | 16 | 80 |
| `xlarge` | 16 | 32 | 160 |

```bash theme={null}
bead create --template base --size small --timeout 300
```

The disk column is fresh-image usable capacity. Storage billing uses unique retained bytes rather than that capacity. Template contents and current usage affect available filesystem space.

## Check availability

Quota, account admission, and current capacity can impose lower limits. Trial supports only `xs` and `small`. After TRIALB activation, trial permits 3 concurrent machines, 4 hours per machine, and 24 admitted machine-hours per UTC day. Standard disk limits are 20 GiB for xs and 40 GiB for small; storage is billed on used bytes. New grants are valid 30 days; existing expiry is preserved. Read live terms in `GET /v1/pricing` and your account balance. Check [trial limits](https://docs.bead.run/platform/trial-credit.md) before creating.

```bash theme={null}
bead limits
bead pricing
```

Xlarge requires placement with sufficient CPU inventory. A size listed here does not guarantee immediate capacity.

## Metered resources

CPU is metered by busy vCPU time and memory by configured GiB while running. Storage is metered by unique retained bytes. Templates with a live desktop, including `computer` and `devbox-computer`, include a desktop add-on while running, whether or not a viewer is connected. Run `bead pricing` or call `GET /v1/pricing` for current rates.

## Change resource bounds

Pause, resume, and fork keep the original size. Memory snapshots require their original CPU and memory size. To choose a different size, create a new machine from a disk template.

For tool payloads, read [templates](https://docs.bead.run/templates/overview.md). For funding details, read [prepaid credit](https://docs.bead.run/platform/prepaid-credit.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.