> ## Documentation Index
> Fetch the complete documentation index at: https://instabox.sh/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Linux machines

> The default machine, a Linux VM of your own with root, Docker, and a persistent disk.

A Linux machine is a VM of your own: it has its own kernel and root with passwordless `sudo`, and most
templates include Docker, so anything you would run on a Linux server runs in it. It is the machine you get when you name no
other type, and it is available on every plan.

```bash CLI theme={null}
instabox create --name dev
```

```ts TypeScript theme={null}
import { Sandbox } from '@insforge/instabox-sdk'

const sbx = await Sandbox.create()
```

```bash API theme={null}
curl -X POST https://api.instabox.sh/v1/machines \
  -H "X-API-Key: $INSTABOX_API_KEY" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{"name": "dev"}'
```

The machine is 4 vCPU / 8 GiB with a 20 GiB disk unless you ask for another
[size](https://instabox.sh/docs/machines/sizes.md). Run a command in it to check that it works:

```bash theme={null}
instabox exec dev -- uname -a
```

## Pick a template

A template decides the distribution and the tools that come preinstalled. A machine starts from
`agent-browser` when you name no template. It has the usual language toolchains, Docker, the coding
agents, and a desktop with a browser. These are the templates most people pick:

| Template | Pick it for |
| - | - |
| `agent-browser` (the default) | coding agents, browsers and computer use, general development |
| `universal` | the same tools, with the desktop installed only when you ask for it |
| `minimal` | a small machine where you install what you need |
| `ci` | GitHub Actions jobs ([CI](https://instabox.sh/docs/use-cases/ci)) |
| `android` | Android 14 with adb ([Android apps](https://instabox.sh/docs/use-cases/android.md)) |
| `omarchy` | Arch Linux with the Omarchy desktop |

Name the template when you create the machine:

```bash theme={null}
instabox create --name phone --template android
```

The free plan creates from agent-browser, android, omarchy, ci only. [Templates](https://instabox.sh/docs/machines/templates.md) shows how to
list them, and [Limits](https://instabox.sh/docs/account/limits.md#machine-specs)
has the distribution, root disk, and tool versions of each.

## What stays and what does not

Files under `/data` stay across stops and pauses. Your home directory is `/data/home`, so a repo you
clone there is still there the next time the machine starts. The software you install with `apt` stays
too. A machine pauses after 30 idle minutes and wakes on the next command, SSH
connection, or visit to one of its ports ([Auto-pause and max-run](https://instabox.sh/docs/machines/auto-pause.md)).

> [card] [Lifecycle](https://instabox.sh/docs/machines/lifecycle.md)
>
> Start, stop, pause, resume, and delete a machine.

> [card] [Run commands](https://instabox.sh/docs/machines/run-commands.md)
>
> Run a command, stream its output, and keep long jobs running.
