Skip to main content
When Risoluto starts without a master key, it enters setup mode and serves a step-by-step wizard at /setup. All routes redirect there until configuration is complete.

​
Wizard Flow

1

Protect Secrets

Generates a master encryption key that protects all stored credentials on disk using AES-256-GCM encryption.Calls POST /api/v1/setup/master-key to derive and persist the key. All subsequent secrets are encrypted at rest in secrets.enc.
Back up your master key immediately. If lost, all encrypted secrets become unrecoverable. Store it in a password manager or secrets vault — never in source control.
Returning to this step after completion shows a confirmation. Click Reconfigure to reset all stored secrets and generate a new key.
2

Connect Linear

Links Risoluto to your Linear workspace:
  1. Stores LINEAR_API_KEY via POST /api/v1/secrets/:key
  2. Fetches available projects with GET /api/v1/setup/linear-projects
  3. Saves the selected tracker.projectSlug to the config overlay
If your Linear workspace has no projects, the wizard displays guidance with a direct link to create one in Linear.
3

Add OpenAI

Risoluto needs OpenAI credentials to run Codex agent workers. Choose one of three authentication methods:
Paste an sk-... key directly. Risoluto validates it against the OpenAI API and stores it in the encrypted secrets store.
# What the wizard calls under the hood
POST /api/v1/setup/openai-key
Content-Type: application/json

{"key": "sk-..."}
4

Add GitHub (Optional)

Validates and stores a GitHub Personal Access Token via POST /api/v1/setup/github-token. This enables automatic PR creation when agents complete work.This step is skippable — you can add a GitHub token later through the dashboard settings.
After completing all steps, click “Go to Dashboard” to unlock normal navigation.
  • Clickable stepper — click any completed step to go back and review or change credentials
  • Keyboard accessible — step indicators support Tab, Enter, and Space
  • Master key reconfigure — returning to Step 1 shows a “Reconfigure” option to reset encryption

​
Reset & Re-run Setup

To re-configure credentials without a full factory reset:
1

Open Setup

Navigate to System → Setup in the sidebar (or go directly to /setup).
2

Reset Credentials

Click “Reset & Re-run Setup” on the done screen and confirm the dialog. All API keys are cleared from the encrypted store.
3

Reconfigure

The wizard restarts from Step 2 — the master key is preserved, so you only need to re-enter service credentials.
To start completely fresh, destroy all named volumes:
docker compose down -v && docker compose up --build -d
The -v flag deletes all named volumes. You lose:
DataRecoverable?
Master key and encrypted secretsNo
Config overlay and auth tokensNo
Agent run archives and logsNo
Cloned workspacesYes — re-cloned on next dispatch
External services (Linear, GitHub, OpenAI) are unaffected.

​
What’s Next

Configuration

Fine-tune agent behavior, models, and sandbox settings.

Docker Deployment

Deploy Risoluto with Docker Compose for production use.
Last modified on March 31, 2026