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

# cloud

The `rumi cloud` commands provision and manage Rumi **private clouds** - Rumi's standardized deployment model.

## What is a Rumi Private Cloud?

A Rumi private cloud is a **standardized deployment architecture** consisting of:

### Platform Services

* **Admin** - Administrative interface and deployment management
* **Agent** - Monitoring and management agent
* **Monitor** - Observability dashboards and metrics
* **Messaging Broker** - Solace, Kafka, or ActiveMQ
* **Bastion** - Secure access gateway and reverse proxy (non-local environments)
* **Name Server** - DNS services (environments without managed DNS like Route 53)

### Application Services

* **User Microservices** - Your deployed Rumi applications

### Key Concept

The private cloud structure is **identical across all environments** - whether running locally in Docker, on bare metal, AWS, Civo, GCP, Azure, or any other infrastructure. This uniformity provides:

* **Consistent deployment model** - Same architecture everywhere
* **Environment portability** - Move applications between environments seamlessly
* **Simplified operations** - Same tooling and procedures across all deployment targets
* **Predictable behavior** - Applications behave identically regardless of underlying infrastructure

## Deployment Environments

| Environment                                    | Description                        | Documentation                                           |
| ---------------------------------------------- | ---------------------------------- | ------------------------------------------------------- |
| [local](/rumi-cli/commands/cloud/local.md)     | Docker-based on your local machine | [Local Commands](/rumi-cli/commands/cloud/local.md)     |
| [aws](/rumi-cli/commands/cloud/aws.md)         | Amazon Web Services                | [AWS Commands](/rumi-cli/commands/cloud/aws.md)         |
| [hetzner](/rumi-cli/commands/cloud/hetzner.md) | Hetzner Cloud                      | [Hetzner Commands](/rumi-cli/commands/cloud/hetzner.md) |
| [civo](/rumi-cli/commands/cloud/civo.md)       | Civo Cloud                         | [Civo Commands](/rumi-cli/commands/cloud/civo.md)       |
| equinix                                        | Equinix Metal bare-metal servers   | Coming soon                                             |
| bare metal                                     | Your own physical infrastructure   | Coming soon                                             |

The `rumi cloud` commands abstract away environment-specific details, allowing you to work with the same standardized private cloud model regardless of where it's deployed.

## Command Structure

```bash
rumi cloud <environment> <command> [options]
```

Where:

* `<environment>` is where to deploy (`local`, `aws`, `hetzner`, `civo`, `equinix`)
* `<command>` is the operation to perform
* `[options]` are command-specific parameters

## Private Cloud Architecture Benefits

The standardized private cloud model provides:

1. **Consistent Operations** - Same commands and procedures across all environments
2. **Easy Migration** - Move applications between environments without changes
3. **Unified Tooling** - Single CLI for all deployment targets
4. **Predictable Scaling** - Add capacity using the same patterns everywhere
5. **Simplified Training** - Learn once, deploy anywhere

## Typical Workflow

```bash
# 1. Develop locally
rumi cloud local provision --message-broker activemq
rumi cloud local deploy --xar my-app.xar

# 2. Test in cloud
rumi cloud aws provision --name dev-cloud --region us-east-1
rumi cloud aws deploy --name dev-cloud --xar my-app.xar

# 3. Deploy to production (same commands, different environment)
rumi cloud aws provision --name prod-cloud --region us-west-2
rumi cloud aws deploy --name prod-cloud --xar my-app.xar
```

## Getting Help

Use `--help` (or `-h`) on any cloud command:

```bash
# General cloud help
rumi cloud --help

# Environment-specific help
rumi cloud local --help
rumi cloud aws --help

# Command-specific help
rumi cloud local provision --help
rumi cloud aws create-network --help
```

## Related Documentation

* [**Installation**](/rumi-cli/installation.md) - Install the Rumi CLI
* [**Quickstart**](/rumi-cli/commands/quickstart.md) - Generate quickstart applications