.env.example

## Required variables
NG_TOKEN=                          # Telegram BOT API token
NGBOT_DATA_PATH=./.data            # Compose-only host path mounted at /data; create it before startup

## Optional variables with defaults
NG_LANG=en                         # Default language for new chats
NG_HANDLERS=admin,gatekeeper,reactor # Enabled bot handlers
NG_LOG_LEVEL=2                     # Log level (0=Panic to 6=Trace)
NG_DOT_PATH=~/.ngbot              # Native bot data path; Compose always overrides this with /data
NG_TELEGRAM_POLL_TIMEOUT=60s      # Telegram long poll timeout
NG_TELEGRAM_REQUEST_TIMEOUT=75s   # Telegram HTTP request timeout
NG_TELEGRAM_RECOVERY_WINDOW=10m   # Maximum degraded polling window before restart
NG_TELEGRAM_INBOX_MAX_PENDING_ROWS=100000 # Maximum aggregate pending/retry update rows
NG_TELEGRAM_INBOX_MAX_PENDING_BYTES=536870912 # Maximum aggregate pending/retry payload bytes
NG_TELEGRAM_INBOX_MAX_DISPATCH_PENDING_ROWS=10000 # Maximum pending/retry rows for one dispatch key
NG_TELEGRAM_INBOX_MAX_DISPATCH_PENDING_BYTES=33554432 # Maximum pending/retry bytes for one dispatch key
NG_TELEGRAM_INBOX_MIN_FREE_BYTES=268435456 # Minimum database filesystem free space required for admission
NG_GATEKEEPER_WEBAPP_PUBLIC_URL=  # Public HTTPS origin for join-request CAPTCHA Mini App
NG_GATEKEEPER_WEBAPP_LISTEN_ADDR=127.0.0.1:8080 # Native listen address; Compose enforces 0.0.0.0:8080 inside the container
NG_GATEKEEPER_WEBAPP_MAX_CONCURRENT=32 # Maximum in-flight Mini App requests; must be greater than zero
NG_GATEKEEPER_WEBAPP_REQUESTS_PER_MINUTE=120 # Per-client Mini App request rate; must be greater than zero
NGBOT_WEBAPP_HOST_PORT=18080        # Host-loopback port shared by Compose and Caddy
NGBOT_VERSION=dev                  # Compose build metadata; set for release builds
NGBOT_REVISION=unknown             # Compose build metadata; set to the exact Git SHA
NGBOT_BUILD_DATE=unknown           # Compose build metadata; set to an RFC 3339 timestamp

## LLM settings
NG_LLM_GEMINI_API_KEY=             # Gemini API key; required for reactor when NG_LLM_API_TYPE=gemini
NG_LLM_OPENAI_API_KEY=             # OpenAI API key; required for reactor when NG_LLM_API_TYPE=openai
NG_LLM_API_KEY=                    # Legacy fallback for the selected provider when its dedicated key is empty
NG_LLM_API_MODEL=                  # Optional model override; empty uses the provider default
NG_LLM_API_URL=https://api.openai.com/v1 # LLM API base URL (used when NG_LLM_API_TYPE=openai)
NG_LLM_API_TYPE=openai             # LLM provider {openai,gemini}; Gemini implicit caching is automatic
NG_LLM_REQUEST_TIMEOUT=45s         # Classification request deadline

## Spam control settings
NG_SPAM_LOG_CHANNEL_USERNAME=     # Channel for spam logging
NG_SPAM_DEBUG_USER_ID=0           # User allowed to run diagnostics in private chat
NG_SPAM_VERBOSE=false             # Verbose in-chat notifications
NG_SPAM_SAFE_MESSAGES_REQUIRED=3 # Distinct safe new messages needed for author trust
NG_SPAM_AUTHOR_TRUST_DURATION=720h # Trust lifetime; one safe new message renews expired trust
NG_SPAM_MESSAGE_PROBATION_DURATION= # Deprecated; accepted with a warning and ignored
NG_SPAM_VOTING_TIMEOUT=5m         # Voting time limit
NG_SPAM_MIN_VOTERS=2              # Minimum required voters
NG_SPAM_MAX_VOTERS=10             # Maximum voters cap
NG_SPAM_MIN_VOTERS_PERCENTAGE=5   # Minimum voter percentage
NG_SPAM_SUSPECT_NOTIFICATION_TIMEOUT=2m # Suspect notification timeout