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

# anona-compute run

> Create a sandbox, run one command, then delete the sandbox

> [!NOTE]
>
> Coming soon: per-run cost. The summary on stderr says `cost: unknown` for now. See [Usage and billing](/docs/usage-and-billing.md) for what your sandboxes used.

```text
Create a sandbox, run one command in it, print a summary on stderr, and delete
the sandbox (also on error or Ctrl-C). anona-compute exits with the command's exit code;
-i/--stdin streams this terminal's stdin to the command.

Cost is printed when the API reports it; the current API does not, so the
summary says "unknown" rather than guessing.

Exit codes:
  0    success
  1    general error
  2    usage error (bad flag, argument or value)
  3    not signed in, or the credential was refused (HTTP 401/403)
  4    not found (HTTP 404)
  5    plan limit or rate limit (HTTP 429, or error_code plan_limit_exceeded)
  exec and run pass the remote command's exit status through unchanged
  (0-255; 130 after Ctrl-C) and exit 125 when anona-compute itself failed,
  for any of the reasons 1-5 above; their --json error keeps that detailed
  code in "cli_code".
```

## Usage

```text
anona-compute run [flags] -- COMMAND [ARGS...]
```

## Flags

| Flag | Type | Description |
| - | - | - |
| `--allow-out` | stringArray | host the sandbox may reach (repeatable); with --no-internet this is the allow-list |
| `--auto-pause` | | pause instead of delete when the timeout ends |
| `--cmd-timeout` | duration | stop waiting for the command after this long (0 = no limit) |
| `--cwd`, `-w` | string | working directory |
| `--env`, `-e` | stringArray | environment variable KEY=VALUE for the sandbox (repeatable) |
| `--help`, `-h` | | help for run |
| `--idle-pause` | string | pause the sandbox after this long with nothing using it (e.g. 15m, 1h); "off" disables it. A duration also makes the timeout pause the sandbox instead of deleting it, as --auto-pause does |
| `--keep` | | do not delete the sandbox after the command |
| `--metadata` | stringArray | metadata KEY=VALUE (repeatable) |
| `--name` | string | a name for the sandbox, shown beside its ID (stored as metadata name=NAME; the ID stays the identifier) |
| `--network-file` | string | JSON egress policy for the sandbox ("-" reads stdin); replaces the flags above |
| `--no-internet` | | create the sandbox without internet access |
| `--size` | string | sandbox size: small (1 vCPU, 2 GiB, 10 GB disk), medium (2, 4 GiB, 20 GB), large (4, 8 GiB, 40 GB) or xl (8, 16 GiB, 80 GB); default: the template's own size (on Free, the smallest size the template allows) |
| `--stdin`, `-i` | | send this terminal's stdin to the command (closed at EOF) |
| `--template`, `-t` | string | template ID or alias (default: profile default\_template, else "base") |
| `--timeout` | string | sandbox lifetime before it is deleted or paused (e.g. 300s, 1h), or "never" for no time limit (default "300s") |
| `--user`, `-u` | string | user to run as (default: the sandbox's default user) |
| `--vault-inject` | stringArray | inject a vault secret into requests to a host: HOST:HEADER=\[bearer:\|basic:]SECRET (repeatable) |

Global flags (`--api-key`, `--api-url`, `--json`, `--output`, `--profile`, `--request-timeout`, `--verbose`) work on every command; see [anona-compute](/docs/cli/reference/anona-compute.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.