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

# Introduction

> Start with the recommended Risoluto path, understand what the system does, and find the next document you need without wading through the whole site.

# Start here

Risoluto is a local orchestration engine that watches your tracker for actionable issues, launches sandboxed AI coding agents inside Docker, and reports the result through pull requests, dashboard state, and API events.

```text theme={null}
You move an issue into an active state → Risoluto claims it → an agent works in an isolated workspace → you review the result
```

<Note>
  **Pre-launch beta.** Risoluto is in pre-launch beta; public availability is targeted for May 2026. Interfaces, config shapes, and defaults may still shift between now and the public release — pin to a specific commit if you need stability today.
</Note>

<Check>
  **First time here?** Start with the [Quickstart](/quickstart). The recommended path is **Docker Compose → setup wizard
  → dashboard**.
</Check>

<Info>
  **Local-first by default.** Risoluto runs on hardware you control. It still talks to the services you configure — such
  as Linear, your model provider, GitHub, and Slack — but your repository data stays in your own workspaces.
</Info>

## Follow the shortest path

<CardGroup cols={3}>
  <Card title="Quickstart" icon="rocket" href="/quickstart">
    Use the recommended Docker + setup wizard flow and verify your first issue end to end.
  </Card>

  <Card title="Setup Wizard" icon="wand-magic-sparkles" href="/guides/setup-wizard">
    See what each first-run step does before you paste credentials or reset anything.
  </Card>

  <Card title="Dashboard" icon="chart-mixed" href="/guides/dashboard">
    Learn where to watch live runs, inspect attempts, and change settings after setup.
  </Card>
</CardGroup>

## Understand the system

<CardGroup cols={2}>
  <Card title="How It Works" icon="diagram-project" href="/concepts/how-it-works">
    Follow the lifecycle from tracker detection to workspace creation, sandbox execution, and delivery.
  </Card>

  <Card title="Trust Model" icon="shield-halved" href="/concepts/trust-model">
    Understand what Risoluto controls, what the agent controls, and where the trust boundaries sit.
  </Card>

  <Card title="API Reference" icon="code" href="/api-reference/overview">
    Use the same HTTP surface the dashboard and setup wizard depend on.
  </Card>

  <Card title="Configuration" icon="gear" href="/guides/configuration">
    Tune concurrency, models, workspace strategy, sandbox settings, and notifications.
  </Card>
</CardGroup>

## What to expect from Risoluto

<CardGroup cols={3}>
  <Card title="Operator-first control" icon="sliders">
    You keep the orchestrator, credentials, and runtime state under your control instead of routing work through a
    hosted control plane.
  </Card>

  <Card title="Isolated execution" icon="docker">
    Each issue runs in its own Docker-backed workspace, with retries, stall handling, and archived attempt history.
  </Card>

  <Card title="Visible runtime state" icon="gauge-high">
    The dashboard, SSE feed, metrics endpoint, and API make it clear what is queued, running, blocked, or finished.
  </Card>
</CardGroup>

## Keep moving

<CardGroup cols={3}>
  <Card title="Docker Deployment" icon="docker" href="/guides/docker">
    Run Risoluto as a persistent service with named volumes and optional remote dispatch.
  </Card>

  <Card title="FAQ" icon="circle-question" href="/faq">
    Get short answers on privacy, Docker, model support, cost, and failure handling.
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/operating/troubleshooting">
    Recover from common setup, auth, sandbox, webhook, and runtime failures.
  </Card>
</CardGroup>