> 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
* **Jump Server** - Secure access gateway (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)     |
| civo                                       | Civo Cloud                         | ⚠️ *In Development*                                 |
| 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`, `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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.rumi.systems/rumi-cli/commands/cloud.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.