# kvbox

> Install kvbox, run kvbox new, and you have a real virtual machine with its own kernel in seconds. A safe sandbox for AI agents, a place to deploy a website or an API, or a throwaway lab for testing. Snapshot a running box and clone it warm.

## Docs

- [Agents](https://kvbox.sh/docs/agents): What makes kvbox easy to drive from a script or an AI agent.
- [Commands](https://kvbox.sh/docs/cli/commands): Every kvbox command, its arguments and options, generated from the CLI itself.
- [Connect and exec](https://kvbox.sh/docs/guides/connect-and-exec): A shell with kvbox connect, scripted commands with kvbox exec.
- [Orgs](https://kvbox.sh/docs/guides/orgs): Share boxes with a team through an org, with owners, admins and members.
- [Sizes and the base image](https://kvbox.sh/docs/guides/sizes): Pick a box size, resize later, and move a box onto a newer base image.
- [Snapshots](https://kvbox.sh/docs/guides/snapshots): Freeze a running box and start warm clones from it.
- [Stop, pause, hibernate](https://kvbox.sh/docs/guides/stop-pause-hibernate): Three ways to put a box away, and what each does with its memory.
- [Usage](https://kvbox.sh/docs/guides/usage): How long a box ran, as vCPU-hours and GiB-hours, and what it cost.
- [Overview](https://kvbox.sh/docs): What kvbox is, what a box is, and where to go next.
- [Install](https://kvbox.sh/docs/install): Install the kvbox CLI on your laptop and log in.
- [Quickstart](https://kvbox.sh/docs/quickstart): Boot a box, get a shell, run a command, take a snapshot, clone it.
- [Install a server](https://kvbox.sh/docs/self-host/install-server): Turn a Linux machine with KVM into a kvbox host.
- [Join a control plane](https://kvbox.sh/docs/self-host/join): Put a host behind api.kvbox.sh or your own control plane.
- [Relay for a home host](https://kvbox.sh/docs/self-host/relay): Lend a public IPv4 to a host behind a home router.
- [Trust a new SSH CA](https://kvbox.sh/docs/self-host/trust-ca): After the control plane rotates its SSH certificate authority, tell each host.