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

# launch-kafka

Provision and start the Kafka broker.

## Syntax

```bash
rumi cloud aws launch-kafka \
  --profile <profile> \
  --network <network> \
  --key-pair <keypair> \
  [options]
```

## Options

| Option               | Short | Description                                                                                                                                | Default        |
| -------------------- | ----- | ------------------------------------------------------------------------------------------------------------------------------------------ | -------------- |
| `--profile`          | `-p`  | AWS profile to use                                                                                                                         | Required       |
| `--region`           | `-r`  | AWS region                                                                                                                                 | `us-east-1`    |
| `--network`          | `-n`  | Name of the Rumi network                                                                                                                   | Required       |
| `--key-pair`         | `-k`  | The network's EC2 key pair                                                                                                                 | Required       |
| `--proxy-server`     | `-a`  | The broker proxy server (nginx `server_name` on the bastion)                                                                               | `null`         |
| `--proxy-port`       | `-b`  | The broker proxy port the bastion's nginx listens on                                                                                       | `0` (no proxy) |
| `--instance-profile` | `-I`  | The IAM instance profile (name or ARN) to attach; required (granting the SSM managed policy) when the network's access method is `ssm-all` | `null`         |
| `--proxy-bastion`    | `-P`  | The name of the bastion that fronts the broker console proxy; required in a multi-bastion network, omitted in a single-bastion network     | none           |

## Example

```bash
rumi cloud aws launch-kafka \
  --profile my-aws-profile \
  --network my-network \
  --key-pair my-keypair
```

## Notes

* Proxy ports recorded here are opened later for specific source CIDRs with the [whitelist](/rumi-cli/commands/cloud/aws/whitelist.md) command.

## See Also

* [start-kafka](/rumi-cli/commands/cloud/aws/start-kafka.md)
* [stop-kafka](/rumi-cli/commands/cloud/aws/stop-kafka.md)
* [terminate-kafka](/rumi-cli/commands/cloud/aws/terminate-kafka.md)