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

# vastai create volume

Create a new volume

## Usage

```bash theme={null}
vastai create volume ID [options]
```

## Arguments

<ParamField path="id" type="integer" required>
  id of volume offer
</ParamField>

## Options

<ParamField path="-s" type="number" default="15">
  size in GB of volume. Default 15 GB. (alias: `--size`)
</ParamField>

<ParamField path="-n" type="string">
  Optional name of volume. (alias: `--name`)
</ParamField>

## Description

Creates a volume from an offer ID (which is returned from "search volumes"). Each offer ID can be used to create multiple volumes,
provided the size of all volumes does not exceed the size of the offer.

## Examples

```bash theme={null}
vastai create volume <ID>
```

## Global Options

The following options are available for all commands:

| Option          | Description                                           |
| --------------- | ----------------------------------------------------- |
| `--url URL`     | Server REST API URL                                   |
| `--retry N`     | Retry limit                                           |
| `--raw`         | Output machine-readable JSON                          |
| `--explain`     | Verbose explanation of API calls                      |
| `--api-key KEY` | API key (defaults to `~/.config/vastai/vast_api_key`) |