Files
archived-gitea-ai-assistant/docs/configuration.md
jeffusion 1e7c80ca9f docs: document LOG_LEVEL configuration and production defaults
Update all documentation to reflect new global LOG_LEVEL environment variable.

- Add LOG_LEVEL to configuration reference tables

- Update deployment guides with LOG_LEVEL=error examples

- Clarify dev (info) vs production (error) log level recommendations

- Add LOG_LEVEL to all .env examples and quick start guides

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)
2026-03-26 23:50:59 +08:00

1.8 KiB

Configuration Reference

Configuration model

This project uses a DB-first runtime configuration model:

  • .env contains only infrastructure-level bootstrap values.
  • Runtime settings (Gitea, providers, secrets, review policy, notifications) are managed in Admin UI and stored in SQLite.

Environment variables (minimal)

Variable Required Description Default
ENCRYPTION_KEY Yes AES-256-GCM master key (64 hex chars) for API key encryption -
PORT No Service port 5174
DATABASE_PATH No SQLite path ./data/assistant.db
LOG_LEVEL No Backend log level (debug/info/warn/error). Default is info; use error in production. info

Generate key:

openssl rand -hex 32

First boot defaults

When database is empty:

  • JWT_SECRET auto-generated
  • WEBHOOK_SECRET auto-generated
  • ADMIN_PASSWORD defaults to password

Change ADMIN_PASSWORD immediately after first login.

Runtime groups in Admin UI

1) Gitea

  • API URL
  • Access token
  • Admin token (optional)

2) Security

  • Webhook secret (HMAC-SHA256 verification)
  • Admin password
  • JWT secret

3) LLM

  • Providers: OpenAI Compatible / OpenAI Responses / Anthropic / Gemini
  • Role mapping: planner, specialist, judge, embedding

4) Notification

  • Feishu webhook and optional secret
  • WeCom (企业微信) webhook

5) Review

  • Engine mode: agent or codex
  • Triage switch
  • Size thresholds (small/medium/large)
  • Execution modes (skip/light/full)
  • Token budgets and concurrency limits

Size and mode are different layers:

  • small/medium/large: change-size classification
  • skip/light/full: review execution depth

6) Memory & learning (optional)

  • ENABLE_MEMORY (default false)
  • Qdrant URL
  • Reflection/debate toggles

Qdrant is only required when memory is enabled.