MindBuzz Configuration

Keep auth and quiz data recoverable.

MindBuzz intentionally keeps its runtime state in simple mounted folders.

Runtime files

  • config/history.db stores manager accounts, per-manager settings, quizzes, and completed quiz runs.
  • config/game.json is a legacy migration source for older installs.
  • config/auth.json stores OIDC provider settings so a bad SSO setup can be repaired outside the database.
  • media/ stores uploaded local audio files served at /media/<filename>.

SSO / OIDC

SSO is optional. The first admin account is always created locally, and local login remains the break-glass fallback.

  • Configure OIDC from the manager admin UI at /manager -> SSO.
  • Use https://your-domain.example/auth/oidc/callback as the production redirect URI.
  • Role mapping can use a claim path such as groups with values like mindbuzz-admin and mindbuzz-manager.

Quiz media

Questions can use optional image, video, and audio URLs. Managers can also upload local audio into the mounted media/ folder.