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

# provision

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

## Syntax

```bash
rumi cloud hetzner provision \
  --api-key <token> \
  --network <network> \
  --key-pair <keypair> \
  [options]
```

## Options

| Option       | Short | Description                                                 | Default  |
| ------------ | ----- | ----------------------------------------------------------- | -------- |
| `--api-key`  | `-k`  | The Hetzner Cloud project API token (or set `HCLOUD_TOKEN`) | Required |
| `--region`   | `-r`  | The Hetzner location to provision in                        | `fsn1`   |
| `--network`  | `-n`  | The name to give the new environment                        | Required |
| `--key-pair` | `-K`  | The SSH key pair to launch with                             | Required |

## Example

```bash
rumi cloud hetzner provision \
  --api-key $HCLOUD_TOKEN \
  --network my-cloud \
  --key-pair rumi
```

## Notes

* Fails if an environment of this name already exists; tear it down first with [deprovision](/rumi-cli/commands/cloud/hetzner/deprovision.md).
* The role snapshots must be baked into the project beforehand (launches boot from them).
* After provisioning, [deploy](/rumi-cli/commands/cloud/hetzner/deploy.md) an application and (optionally) [add-proxy](/rumi-cli/commands/cloud/hetzner/add-proxy.md) it publicly.

## See Also

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