New users currently need to hand-edit environment variables and infer whether SAB, paths, auth, and permissions are valid. Radarr/Sonarr-style services guide users through initial setup instead of leaving them to compose files and logs.
Proposed change
Add a first-run setup wizard that validates the core service configuration before automatic imports are enabled.
Scope
SAB URL/API key form and connection test.
Owned SAB category selection, default manual.
Download root, movies root, and TV root selection/validation.
Auth token / reverse-proxy mode selection.
Permission diagnostics before saving.
Clear success/failure messages with next steps.
Acceptance criteria
A new install with no completed setup opens the setup wizard.
The wizard can verify SAB connectivity without exposing the API key.
Invalid paths or unwritable roots block completion with actionable messages.
Setup result is persisted safely and reflected on /api/status.
## Problem
New users currently need to hand-edit environment variables and infer whether SAB, paths, auth, and permissions are valid. Radarr/Sonarr-style services guide users through initial setup instead of leaving them to compose files and logs.
## Proposed change
Add a first-run setup wizard that validates the core service configuration before automatic imports are enabled.
## Scope
- SAB URL/API key form and connection test.
- Owned SAB category selection, default `manual`.
- Download root, movies root, and TV root selection/validation.
- Auth token / reverse-proxy mode selection.
- Permission diagnostics before saving.
- Clear success/failure messages with next steps.
## Acceptance criteria
- A new install with no completed setup opens the setup wizard.
- The wizard can verify SAB connectivity without exposing the API key.
- Invalid paths or unwritable roots block completion with actionable messages.
- Setup result is persisted safely and reflected on `/api/status`.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Problem
New users currently need to hand-edit environment variables and infer whether SAB, paths, auth, and permissions are valid. Radarr/Sonarr-style services guide users through initial setup instead of leaving them to compose files and logs.
Proposed change
Add a first-run setup wizard that validates the core service configuration before automatic imports are enabled.
Scope
manual.Acceptance criteria
/api/status.