Configuration

Ideon uses environment variables for configuration. The primary file is .env, which can be generated by the installer.

Environment Variables

Core

• APP_PORT: Port for HTTP and WebSocket traffic.
• APP_URL: Public base URL for links and OAuth callbacks.
• TIMEZONE: Label for server logs.

Database

• SQLITE_PATH: Path to SQLite file in development.
• DB_HOST: Postgres host.
• DB_PORT: Postgres port.
• DB_NAME: Postgres database name.
• DB_USER: Postgres username.
• DB_PASS: Postgres password.
• DB_SSL: Set to true to enable TLS.

Security

• SECRET_KEY: Master key used to derive internal secrets.
• AUTH_URL: Override for Auth.js base URL.
• LOG_LEVEL: Pino logger level.
• DEV_ALLOWED_ORIGINS: Comma separated origins to allow for CORS in development.

SMTP

• SMTP_FROM_EMAIL: Sender address.
• SMTP_FROM_NAME: Sender display name.
• SMTP_HOST: SMTP host.
• SMTP_PORT: SMTP port.
• SMTP_USER: SMTP username.
• SMTP_PASSWORD: SMTP password.
• SMTP_USE_TLS: true or false for STARTTLS.

Tokens

• GITHUB_TOKEN: Optional token to lift GitHub API rate limits for repository stats.

Database Mode

• Development uses SQLite when NODE_ENV=development.
• Production uses Postgres when DB_HOST, DB_NAME, DB_USER, and DB_PASS are set.