> For the complete documentation index, see [llms.txt](https://hyperhq.gitbook.io/pi-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://hyperhq.gitbook.io/pi-docs/reference/cli/volume/create.md).

# create

Create new volume

```
Usage: pi create volume VOLUME [OPTIONS]

Create a new volume

          -e, --access-key                API access key
          -k, --secret-key                API secret key
          -r, --region                    Region name, default: gcp-us-central1
          -u, --user                      Username
          --size                          Volume size (in GB), 1-1024, default 10
          --zone                          Availability zone
```

Volume is zone-specific. You may use the `--zone` flag to choose which availability zone the volume will reside in. If is absent, the volume will be created in the default zone of your account. Volume name is region-wise unique, e.g. no two volumes in the same region can have the same volume name.

```bash
$ pi create volume vol1 --size=1 --zone=gcp-us-central1-a
volume/vol1
```
