Skip to content

First-time setup wizard: configure hub via UI instead of env vars #195

Description

@benders

Replace env-var-driven hub configuration with a first-run setup wizard surfaced at initial login.

Motivation

Current bootstrap requires editing .env / docker-compose env before first launch (admin password, instance name, federation keys, etc). Painful for non-technical operators and conflicts with packaged distribution (macOS launchd, eventual installer).

Scope (initial)

  • Detect "unconfigured" state on hub boot (no admin user / no instance identity)
  • Serve a setup route that bypasses normal auth
  • Wizard collects: admin credentials, instance display name, optional federation bootstrap
  • Persist to DB; subsequent boots skip wizard
  • Existing env vars remain supported as override / non-interactive install path

Out of scope

  • Re-configuration after setup (separate admin settings page — file follow-up)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions