Skip to main content

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.

Use this page while the setup wizard is on screen at /setup, or before you re-run setup from the dashboard. When Risoluto starts without a master key, it enters setup mode and redirects normal navigation into the wizard until the required first-run steps are complete.

​
What you need before you begin

ItemRequiredWhy it matters
Linear API keyYesLets Risoluto validate your workspace and list projects
OpenAI auth methodYesNeeded to run Codex-backed agent workers
GitHub tokenNoEnables automatic PR creation after successful runs

​
Wizard flow

1

Protect Secrets

Generates the master key used to encrypt credentials at rest with AES-256-GCM.Under the hood, the wizard calls POST /api/v1/setup/master-key and persists the result locally.
Back up the master key. If you lose it, previously encrypted secrets cannot be recovered.
2

Connect Linear

Stores your Linear API key, fetches the list of available projects, and saves the project Risoluto should monitor.The wizard uses:
  1. POST /api/v1/secrets/:key
  2. GET /api/v1/setup/linear-projects
  3. Config overlay updates for the selected project slug
If Linear returns no projects, the wizard shows guidance before you can continue.
3

Add OpenAI

Choose one authentication path for Codex-backed workers.
Paste an sk-... key. Risoluto validates it and stores it in the encrypted secret store.
POST /api/v1/setup/openai-key
4

Add GitHub (optional)

Stores a GitHub Personal Access Token so successful runs can open or update pull requests automatically.You can skip this step and add the token later from the dashboard.
After the final step, choose Go to Dashboard to leave setup mode.

​
Re-run setup later

1

Open Setup

Navigate to System → Setup in the dashboard, or go directly to /setup.
2

Reset API credentials from the done screen

Use Reset & Re-run Setup on the completed screen to clear the stored Linear, OpenAI, and GitHub credentials. The wizard restarts at Connect Linear and keeps the current master key.
3

Regenerate the master key only when you need to

Use Reconfigure on Protect Secrets when you want a new master key. That restarts the wizard from Protect Secrets and generates a new key. Use Factory reset below only when you need a full wipe of the master key, encrypted secrets, overlay config, archives, and cached workspaces.

​
Accessibility and navigation behavior

  • Clickable stepper — return to completed steps to review or change entries
  • Keyboard support — step controls work with Tab, Enter, and Space
  • Reconfigure path — the first step changes after completion so you can rotate credentials without guessing where to start
To start completely fresh, delete the named Docker volumes and boot the stack again:
docker compose down -v
docker compose up --build -d
This removes the master key, encrypted secrets, overlay config, archives, and cached workspaces stored in those volumes.

​
What’s next

Quickstart

Follow the recommended first-run path from clone to smoke issue.

Dashboard

Learn where to confirm setup, inspect runs, and change configuration.

Configuration

Adjust runtime behavior after setup is complete.

Docker Deployment

Move from first boot to a persistent deployment layout.
Last modified on April 3, 2026