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

# provision

Provision a complete Rumi environment in one step: create the private network and launch the standard platform (bastion, admin, monitor, solace) on it. A convenience over [create-network](/rumi-cli/commands/cloud/civo/create-network.md) + [launch-platform](/rumi-cli/commands/cloud/civo/launch-platform.md).

## Syntax

```bash
rumi cloud civo provision \
  --api-key <token> \
  --region <region> \
  --network <network> \
  --keyPair <keypair> \
  [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 provision in (e.g. `FRA1`)       | Required |
| `--network` | `-n`  | The name of the network (VPC) to create             | Required |
| `--keyPair` | `-K`  | The network SSH key pair                            | Required |

## Example

```bash
rumi cloud civo provision \
  --api-key $CIVO_API_TOKEN \
  --region FRA1 \
  --network my-cloud \
  --keyPair rumi
```

## Notes

* Fails if an environment of this name already exists; tear it down first with [deprovision](/rumi-cli/commands/cloud/civo/deprovision.md).
* Because Civo installs software at boot (cloud-init), first-boot provisioning takes longer than a prebaked-image provider.
* After provisioning, [deploy](/rumi-cli/commands/cloud/civo/deploy.md) an application and (optionally) run [enable-https](/rumi-cli/commands/cloud/civo/enable-https.md).

## See Also

* [deploy](/rumi-cli/commands/cloud/civo/deploy.md)
* [deprovision](/rumi-cli/commands/cloud/civo/deprovision.md)
* [create-network](/rumi-cli/commands/cloud/civo/create-network.md)
* [launch-platform](/rumi-cli/commands/cloud/civo/launch-platform.md)