> For the complete documentation index, see [llms.txt](https://docs.rumi.systems/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.rumi.systems/rumi-cli/commands/cloud/aws/attach-volume.md).

# attach-volume

Provision, attach and optionally mount a new EBS volume onto a Rumi service instance.

## Syntax

```bash
rumi cloud aws attach-volume \
  --profile <profile> \
  --network <network> \
  --key-pair <keypair> \
  --instanceName <instance> \
  [options]
```

## Options

| Option                 | Short | Description                                                    | Default               |
| ---------------------- | ----- | -------------------------------------------------------------- | --------------------- |
| `--profile`            | `-p`  | AWS profile to use                                             | Required              |
| `--region`             | `-r`  | AWS region                                                     | `us-east-1`           |
| `--network`            | `-n`  | Name of the Rumi network containing the instance               | Required              |
| `--key-pair`           | `-k`  | The network's EC2 key pair                                     | Required              |
| `--zone`               | `-z`  | Hosted zone the instance belongs to                            | `rumi.local`          |
| `--instanceName`       | `-i`  | Short name of the instance to attach the volume to             | Required              |
| `--instanceNameInZone` | `-j`  | DNS name of the instance within the hosted zone                | `--instanceName`      |
| `--volumeName`         | `-u`  | Name tag to assign to the new volume                           | `<noname>`            |
| `--volumeType`         | `-t`  | Volume type (`GP3`, `SC1`, `ST1`)                              | `GP3`                 |
| `--volumeSize`         | `-v`  | Size, in GiB, of the new volume                                | `1`                   |
| `--snapshot`           | `-s`  | Snapshot id to create the volume from                          | `null` (fresh volume) |
| `--mountPoint`         | `-m`  | Mount point on the instance                                    | `null` (not mounted)  |
| `--tag`                | `-T`  | A tag (`key=value`) to apply to the created volume; repeatable | none                  |

## See Also

* [launch-instance](/rumi-cli/commands/cloud/aws/launch-instance.md)
* [list-instances](/rumi-cli/commands/cloud/aws/list-instances.md)