# rrun documentation

rrun ("remote run") runs a folder's command on the cheapest machine that fits,
from one GPU for a quick experiment to eight for a big run, on any
[supported cloud](https://rrun.041.io/docs/clouds.md) you connect. Logs stream back while it runs, and
the machine is deleted when nothing needs it.

The `o41-rrun` command line is the main way in, and it is built for agents as
much as for people. The web app at `/app` does the same things. Training runs
there are a good fit for [SexpGPU](https://sx.041.io); their curves go to
[Metrics by 041](https://metrics.041.io) and their checkpoints to
[Artifacts by 041](https://artifacts.041.io).

rrun is an early release. For a bug or anything missing, such as a cloud or a
GPU, run `o41-rrun feedback "<what you need>" --reply-to <you@company.com>` or
use the web app's Feedback page. For help, email
[niko@041.io](mailto:niko@041.io).

## Start

- [Getting started](https://rrun.041.io/docs/getting-started.md) — Install the CLI, sign in, connect a
  cloud, run a folder and follow its logs.
- [How it works](https://rrun.041.io/docs/how-it-works.md) — A job from start to finish, and what happens
  when something goes wrong.

## Use

- [Jobs and logs](https://rrun.041.io/docs/jobs-and-logs.md) — What gets packed, the command, env and
  secrets, statuses and failure reasons, restarts, logs and telemetry.
- [Machines and costs](https://rrun.041.io/docs/machines-and-costs.md) — Offers and prices, how a machine
  is picked, spot, idle machines and `--keep`, reserved machines of your own,
  the sweeper, disks and limits.
- [API keys and agents](https://rrun.041.io/docs/api-keys-and-agents.md) — Driving rrun from an agent or
  CI: API keys, `--json`, exit codes and environment variables.
- [Web app](https://rrun.041.io/docs/web-app.md) — The pages at `/app` and the CLI command each one
  matches.

## Setup

- [Clouds](https://rrun.041.io/docs/clouds.md) — Connect Vast, RunPod, Verda, Google Cloud and Nebius,
  one or more accounts each; turn accounts on and off for GPU and CPU jobs;
  Google Cloud and Nebius keyless, through rrun's OIDC issuer.
- [Log storage](https://rrun.041.io/docs/storage.md) — Keep job logs and telemetry in your own
  S3-compatible bucket.

## Reference

- [Command line](https://rrun.041.io/docs/cli.md) — Every `o41-rrun` command and flag, output and exit
  codes.
- [HTTP API](https://rrun.041.io/docs/api.md) — The routes under `/api/v1`, authentication and errors.

---

rrun by 041 documentation. Every page: https://rrun.041.io/llms.txt