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

# launch-instance

Provision and start a service instance.

## Syntax

```bash
rumi cloud local launch-instance --name <name> --hostname <hostname> [--ports <ports>]
```

## Options

| Option       | Short | Description                             | Required |
| ------------ | ----- | --------------------------------------- | -------- |
| `--name`     | `-n`  | Name of the service instance            | Yes      |
| `--hostname` | `-t`  | Hostname for the service                | Yes      |
| `--ports`    | `-p`  | Comma-separated list of ports to expose | No       |

## Example

```bash
rumi cloud local launch-instance --name processor-1 --hostname processor-1.local --ports 8080,8443
```

## See Also

* [start-instance](/rumi-cli/commands/cloud/local/start-instance.md)
* [stop-instance](/rumi-cli/commands/cloud/local/stop-instance.md)
* [terminate-instance](/rumi-cli/commands/cloud/local/terminate-instance.md)
* [list-instances](/rumi-cli/commands/cloud/local/list-instances.md)