# kosa8 cloud launch

Launch a template from the gallery and wait for its first win

## Usage

```
kosa8 cloud launch ID
```

Creates the template's sandbox with every setting it names (size, network,
keys), runs its setup inside it, and prints the first thing to try. A key it
needs is asked for once (input hidden) and stored as a kosa8 secret: the
sandbox only ever holds a placeholder. kosa8 cloud templates lists the IDs.

## Flags

| Flag | Type | What it does | Default |
|---|---|---|---|
| `--from-env` | bool | take a key the template needs from this shell's variable of the same name (e.g. ANTHROPIC_API_KEY) |  |
| `--name` | string | the sandbox's name |  |
| `--no-wait` | bool | answer once the sandbox is created; setup goes on |  |
| `--region` | string | a region (us-ash1, eu-hel1) or area (us, eu) |  |
| `--size` | string | another size than the template's (2x4, 4x8, 8x16, 16x32) |  |
| `--timeout` | duration | how long to wait for the setup | `15m0s` |

## Example

```
  kosa8 cloud launch web-app
  kosa8 cloud launch claude-code --name my-agent
  ANTHROPIC_API_KEY=… kosa8 cloud launch claude-code --from-env
  kosa8 cloud launch data-analysis --size 4x8 --no-wait --json
```

---
Source: https://docs.kosa8.com/reference/cloud-launch/
