## pyre volume create

Create a volume

### Synopsis

Creates a volume on your hub. --type is how the appliance will present
it on your computer: nfs (Linux, macOS), smb (Windows, macOS), iscsi,
none (block device only) or nfs+smb. Sizes use decimal units (100GB =
10^11 bytes) unless written as GiB.

--encryption customer encrypts every block with a key only you hold.
The key file is created on the computer that runs the appliance by
"pyre appliance deploy" (~/.pyre/<container>.key); the server never
sees it, so losing the file makes the volume unrecoverable by anyone.
Fixed at creation.

```
pyre volume create <name> [flags]
```

### Examples

```
  pyre volume create backups --size 100GB --type nfs
  pyre volume create shares --size 2TB --type smb --encryption customer
  pyre volume create archive --size 500GB --type nfs --store 3   # on your own S3 store
```

### Options

```
      --compression string      how new blocks are compressed before upload: zstd, deflate or off (default "zstd")
      --compression-level int   zstd 1-19 (default 3), deflate 1-9 (default 6)
      --encryption string       customer (a key only you hold, created on your computer at deploy) or none (default "none")
  -h, --help                    help for create
      --no-reclaim              keep freed blocks instead of handing them back to the store (see pyre volume reclaim)
      --size string             size, e.g. 100GB, 2TB, 50GiB (required)
      --store int               id of your own S3 store to keep the data on (see: pyre store list)
      --type string             presentation: nfs, smb, iscsi, none or nfs+smb (default "nfs")
      --writeback string        when writes are uploaded: vm, files or database (default: vm for iscsi, files otherwise; see pyre volume writeback)
```

### Options inherited from parent commands

```
      --api string       API base URL (default from the profile, or https://api.pyredata.io)
      --ca-cert string   PEM file with an extra CA to trust (self-hosted managers)
      --insecure         skip TLS certificate verification (lab use only)
  -o, --output string    output format: table, json or plain (default "table")
      --profile string   config profile to use (see: pyre config)
  -q, --quiet            print results only, no notices
      --token string     API token (default from the profile; prefer PYRE_TOKEN in scripts)
  -y, --yes              answer yes to every confirmation (for scripts)
```

### SEE ALSO

* [pyre volume](pyre_volume.md)	 - Create, list, resize and delete volumes