# rrun by 041

> rrun by 041 runs your command on the cheapest cloud machine that fits, from one GPU for a quick experiment to eight for a big run, on the clouds you connect. One CLI built for agents and a web app that does the same: run jobs, follow logs, and stop paying when the work is done.

Every link below is a markdown page. Any docs page also answers with markdown when asked for `Accept: text/markdown` or fetched with curl.

## 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.

## Optional

- [Landing page](https://rrun.041.io/index.md): the quickstart, how a job finds a machine, the clouds, agent use and cost hygiene