# kosa8 range

Run a cyber range: a live copy of one prepared scenario per trainee

A scenario file (YAML or JSON) names a base image or snapshot, the
containers and setup commands that prepare it, the trainees' egress, and
the objectives they are scored on. `range up` prepares it once, snapshots
it running, and restores one clone per trainee — each its own VM on its
own isolated network. `range check` scores them into the audit log;
`range reset` puts one trainee back in about a second; `kosa8 desk` shows
the instructor view.

## Subcommands

- [`kosa8 range check`](https://docs.kosa8.com/reference/range-check.md): Run the objective checks and record the scores in the audit log
- [`kosa8 range down`](https://docs.kosa8.com/reference/range-down.md): Record every trainee's final result, then remove the range
- [`kosa8 range reset`](https://docs.kosa8.com/reference/range-reset.md): Put one trainee's machine back to the prepared scenario
- [`kosa8 range status`](https://docs.kosa8.com/reference/range-status.md): Show each trainee's objectives, score and time
- [`kosa8 range up`](https://docs.kosa8.com/reference/range-up.md): Prepare a scenario once and give every trainee a live clone of it
- [`kosa8 range validate`](https://docs.kosa8.com/reference/range-validate.md): Check a scenario file and say what a range of it would cost

---
Source: https://docs.kosa8.com/reference/range/