# kosa8 cloud swarm up

Checkpoint a sandbox and fork it into a swarm of N members

## Usage

```
kosa8 cloud swarm up NAME
```

NAME is 1-40 lowercase letters, digits or '-'. Members are named NAME-1 … NAME-N
and labelled swarm=NAME. Without --allow, --deny, --preset or --no-internet the
members take the parent's own egress policy, else the organization's. Forks are
held to the same payment, quota and fork limits (up to 100) as kosa8 cloud sandbox fork.

## Flags

| Flag | Type | What it does | Default |
|---|---|---|---|
| `--allow` | stringSlice | only these hosts (*.domain, IPv4, CIDR); repeat or comma-separate | `[]` |
| `--count, -n` | int | how many members (1-100) | `0` |
| `--deny` | stringSlice | block these hosts | `[]` |
| `--from` | string | the sandbox to fork the members from |  |
| `--no-internet` | bool | nothing leaves but what --allow and --preset name |  |
| `--preset` | stringSlice | allow a registry preset (npm, pypi, github, common, …) | `[]` |

## Example

```
  kosa8 cloud swarm up triage --from sbx_123 -n 10
  kosa8 cloud swarm up triage --from sbx_123 -n 5 --no-internet --allow api.openai.com
```

---
Source: https://docs.kosa8.com/reference/cloud-swarm-up/
