Skip to content

Application Settings

Basic application configuration for the LambChat server.

VariableDefaultDescription
DEBUGfalseEnable debug/reload mode. Sets log verbosity and enables hot reload in development.
HOST0.0.0.0Server bind host. Use 127.0.0.1 to restrict to localhost only.
PORT8000Server bind port.
APP_BASE_URL(empty)Base URL for generating file URLs. Required when using a reverse proxy. Example: https://lambchat.example.com
APP_NAMELambChatApplication name (read-only, hardcoded).
APP_VERSION(auto)Auto-read from pyproject.toml at startup.
LOG_LEVELINFOLogging level. Options: DEBUG, INFO, WARNING, ERROR, CRITICAL.

Example

bash
# .env
DEBUG=false
HOST=0.0.0.0
PORT=8000
APP_BASE_URL=https://lambchat.example.com
LOG_LEVEL=INFO

TIP

When deploying behind a reverse proxy (nginx, Traefik, Cloudflare Tunnel), always set APP_BASE_URL to the public-facing URL. This ensures file upload URLs, sharing links, and OAuth callbacks work correctly.