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

# aws

The `rumi cloud aws` commands provision and manage Rumi private clouds in Amazon Web Services (AWS).

## Overview

AWS commands provide complete lifecycle management for Rumi private clouds:

* **Network Infrastructure** - Create and manage VPCs, subnets, and security groups
* **DNS Management** - Set up hosted zones for private cloud domains
* **Platform Services** - Deploy Jump, Admin, Monitor, and messaging services
* **Application Deployment** - Deploy and manage your Rumi applications
* **Lifecycle Management** - Provision, start, stop, and deprovision entire clouds

## Prerequisites

Before using AWS commands, you must:

1. **Install the AWS CLI** - Version 2.x required
2. **Configure AWS credentials** - See [AWS Setup](/rumi-cli/installation/aws-setup.md) for detailed instructions
3. **Have appropriate IAM permissions** - EC2 and Route53 access required

## Commands

### Network Management

| Command                                                          | Description                     |
| ---------------------------------------------------------------- | ------------------------------- |
| [create-network](/rumi-cli/commands/cloud/aws/create-network.md) | Create a new Rumi network (VPC) |
| [list-networks](/rumi-cli/commands/cloud/aws/list-networks.md)   | List all Rumi networks          |
| [delete-network](/rumi-cli/commands/cloud/aws/delete-network.md) | Delete a Rumi network           |

### DNS Management

| Command                                                    | Description          |
| ---------------------------------------------------------- | -------------------- |
| [create-zone](/rumi-cli/commands/cloud/aws/create-zone.md) | Create a hosted zone |
| [list-zones](/rumi-cli/commands/cloud/aws/list-zones.md)   | List hosted zones    |

### Jump Server

| Command                                                          | Description                             |
| ---------------------------------------------------------------- | --------------------------------------- |
| [launch-jump](/rumi-cli/commands/cloud/aws/launch-jump.md)       | Provision and start Jump server         |
| [start-jump](/rumi-cli/commands/cloud/aws/start-jump.md)         | Start Jump server                       |
| [stop-jump](/rumi-cli/commands/cloud/aws/stop-jump.md)           | Stop Jump server                        |
| [terminate-jump](/rumi-cli/commands/cloud/aws/terminate-jump.md) | Remove Jump server                      |
| [add-proxy](/rumi-cli/commands/cloud/aws/add-proxy.md)           | Add an nginx proxy entry on Jump server |

### Admin Service

| Command                                                              | Description                       |
| -------------------------------------------------------------------- | --------------------------------- |
| [launch-admin](/rumi-cli/commands/cloud/aws/launch-admin.md)         | Provision and start Admin service |
| [start-admin](/rumi-cli/commands/cloud/aws/start-admin.md)           | Start Admin service               |
| [stop-admin](/rumi-cli/commands/cloud/aws/stop-admin.md)             | Stop Admin service                |
| [terminate-admin](/rumi-cli/commands/cloud/aws/terminate-admin.md)   | Remove Admin service              |
| [run-admin-script](/rumi-cli/commands/cloud/aws/run-admin-script.md) | Execute an admin script           |

### Monitor Service

| Command                                                                | Description                         |
| ---------------------------------------------------------------------- | ----------------------------------- |
| [launch-monitor](/rumi-cli/commands/cloud/aws/launch-monitor.md)       | Provision and start Monitor service |
| [start-monitor](/rumi-cli/commands/cloud/aws/start-monitor.md)         | Start Monitor service               |
| [stop-monitor](/rumi-cli/commands/cloud/aws/stop-monitor.md)           | Stop Monitor service                |
| [terminate-monitor](/rumi-cli/commands/cloud/aws/terminate-monitor.md) | Remove Monitor service              |

### Message Brokers

| Command                                                              | Description                |
| -------------------------------------------------------------------- | -------------------------- |
| [launch-solace](/rumi-cli/commands/cloud/aws/launch-solace.md)       | Provision and start Solace |
| [start-solace](/rumi-cli/commands/cloud/aws/start-solace.md)         | Start Solace               |
| [stop-solace](/rumi-cli/commands/cloud/aws/stop-solace.md)           | Stop Solace                |
| [terminate-solace](/rumi-cli/commands/cloud/aws/terminate-solace.md) | Remove Solace              |
| [launch-kafka](/rumi-cli/commands/cloud/aws/launch-kafka.md)         | Provision and start Kafka  |
| [start-kafka](/rumi-cli/commands/cloud/aws/start-kafka.md)           | Start Kafka                |
| [stop-kafka](/rumi-cli/commands/cloud/aws/stop-kafka.md)             | Stop Kafka                 |
| [terminate-kafka](/rumi-cli/commands/cloud/aws/terminate-kafka.md)   | Remove Kafka               |

### Platform

| Command                                                                  | Description                  |
| ------------------------------------------------------------------------ | ---------------------------- |
| [launch-platform](/rumi-cli/commands/cloud/aws/launch-platform.md)       | Provision and start platform |
| [start-platform](/rumi-cli/commands/cloud/aws/start-platform.md)         | Start platform               |
| [stop-platform](/rumi-cli/commands/cloud/aws/stop-platform.md)           | Stop platform                |
| [terminate-platform](/rumi-cli/commands/cloud/aws/terminate-platform.md) | Remove platform              |

### Instance Management

| Command                                                                  | Description                      |
| ------------------------------------------------------------------------ | -------------------------------- |
| [launch-instance](/rumi-cli/commands/cloud/aws/launch-instance.md)       | Launch an EC2 instance           |
| [start-instance](/rumi-cli/commands/cloud/aws/start-instance.md)         | Start an instance                |
| [stop-instance](/rumi-cli/commands/cloud/aws/stop-instance.md)           | Stop an instance                 |
| [terminate-instance](/rumi-cli/commands/cloud/aws/terminate-instance.md) | Terminate an instance            |
| [list-instances](/rumi-cli/commands/cloud/aws/list-instances.md)         | List all instances               |
| [attach-volume](/rumi-cli/commands/cloud/aws/attach-volume.md)           | Attach an EBS volume             |
| [run-command](/rumi-cli/commands/cloud/aws/run-command.md)               | Execute a command on an instance |

### High-Level Lifecycle

| Command                                                    | Description                        |
| ---------------------------------------------------------- | ---------------------------------- |
| [provision](/rumi-cli/commands/cloud/aws/provision.md)     | Provision a complete private cloud |
| [deploy](/rumi-cli/commands/cloud/aws/deploy.md)           | Deploy an application              |
| [configure](/rumi-cli/commands/cloud/aws/configure.md)     | Configure an application           |
| [start](/rumi-cli/commands/cloud/aws/start.md)             | Start all services                 |
| [stop](/rumi-cli/commands/cloud/aws/stop.md)               | Stop all services                  |
| [deprovision](/rumi-cli/commands/cloud/aws/deprovision.md) | Remove a private cloud             |

## Common Options

Most AWS commands support these common options:

| Option          | Description                           |
| --------------- | ------------------------------------- |
| `-p, --profile` | AWS profile to use (required)         |
| `-r, --region`  | AWS region (default: us-east-1)       |
| `-n, --name`    | Name of the resource or private cloud |

## Typical Workflow

```bash
# 1. Provision a complete private cloud
rumi cloud aws provision \
  --profile my-aws-profile \
  --name my-cloud \
  --network my-network \
  --message-broker solace

# 2. Deploy your application
rumi cloud aws deploy \
  --profile my-aws-profile \
  --name my-cloud \
  --xar my-app.xar

# 3. Start all services
rumi cloud aws start --profile my-aws-profile --name my-cloud

# 4. Stop when not in use (saves costs)
rumi cloud aws stop --profile my-aws-profile --name my-cloud

# 5. Clean up when done
rumi cloud aws deprovision --profile my-aws-profile --name my-cloud
```

## Related Documentation

* [**AWS Setup**](/rumi-cli/installation/aws-setup.md) - Configure AWS CLI and credentials
* [**Local Commands**](/rumi-cli/commands/cloud/local.md) - Docker-based local deployments
* [**Installation**](/rumi-cli/installation.md) - Install the Rumi CLI


---

# 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/aws.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.