> 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/civo/deploy.md).

# deploy

Deploy a Rumi system (a XAR) to a provisioned environment. The XAR is staged on the bastion and uploaded to the admin node's agent, which deploys it onto the service workers.

## Syntax

```bash
rumi cloud civo deploy \
  --api-key <token> \
  --region <region> \
  --network <network> \
  --keyPair <keypair> \
  --xar <path> \
  [options]
```

## Options

| Option      | Short | Description                                         | Default  |
| ----------- | ----- | --------------------------------------------------- | -------- |
| `--api-key` | `-k`  | The Civo API token to use (or set `CIVO_API_TOKEN`) | Required |
| `--region`  | `-r`  | The Civo region to use (e.g. `FRA1`)                | Required |
| `--network` | `-n`  | The name of the environment to deploy the system to | Required |
| `--keyPair` | `-K`  | The network SSH key pair                            | Required |
| `--xar`     | `-x`  | The path to the XAR system to deploy                | Required |

## Example

```bash
rumi cloud civo deploy \
  --api-key $CIVO_API_TOKEN \
  --region FRA1 \
  --network my-cloud \
  --keyPair rumi \
  --xar ./my-app.xar
```

## Notes

* The bastion must be running (it stages and uploads the XAR).
* Set controller properties before or after deploy with [configure](/rumi-cli/commands/cloud/civo/configure.md).

## See Also

* [provision](/rumi-cli/commands/cloud/civo/provision.md)
* [configure](/rumi-cli/commands/cloud/civo/configure.md)