.env.example

# ── Required ──────────────────────────────────────────────────
# Session encryption key. Must be at least 32 characters.
# In development mode (bun run dev), a hardcoded dev secret is used automatically.
# In production (bun run start), this MUST be set.
SESSION_SECRET=

# ── Optional ─────────────────────────────────────────────────
# Bearer token required to scrape the /metrics (Prometheus) endpoint.
# The endpoint returns 401 if this is unset or the token does not match.
# ADMIN_PANEL_METRICS_SECRET=

# Browser-facing URL of the LibreChat API server (used for OAuth redirects).
# Defaults to http://localhost:3080
# VITE_API_BASE_URL=http://localhost:3080

# Server-side URL for LibreChat API calls. Falls back to VITE_API_BASE_URL.
# Useful when the server reaches LibreChat on a different URL than the browser.
# API_SERVER_URL=http://localhost:3080

# Force SSO-only login (hides the email/password form)
# ADMIN_SSO_ONLY=false

# Session idle timeout in milliseconds (default: 30 minutes)
# ADMIN_SESSION_IDLE_TIMEOUT_MS=1800000

# Whether the session cookie should only be sent over HTTPS.
# Defaults to true in production, false otherwise.
# SESSION_COOKIE_SECURE=true

# ── Cache Control ────────────────────────────────────────────
# These mirror LibreChat's cache env vars. ADMIN_PANEL_* variants
# take precedence, falling back to the shared LibreChat equivalents.

# Static asset caching (hashed files in /assets/)
# STATIC_CACHE_MAX_AGE=172800        # browser max-age in seconds (default: 2 days)
# STATIC_CACHE_S_MAX_AGE=86400       # CDN s-maxage in seconds (default: 1 day)
# ADMIN_PANEL_STATIC_CACHE_MAX_AGE=  # overrides STATIC_CACHE_MAX_AGE for admin panel
# ADMIN_PANEL_STATIC_CACHE_S_MAX_AGE= # overrides STATIC_CACHE_S_MAX_AGE for admin panel

# HTML / index response caching
# INDEX_CACHE_CONTROL=no-cache, no-store, must-revalidate
# INDEX_PRAGMA=no-cache
# INDEX_EXPIRES=0
# ADMIN_PANEL_INDEX_CACHE_CONTROL=   # overrides INDEX_CACHE_CONTROL for admin panel
# ADMIN_PANEL_INDEX_PRAGMA=          # overrides INDEX_PRAGMA for admin panel
# ADMIN_PANEL_INDEX_EXPIRES=         # overrides INDEX_EXPIRES for admin panel