.env.example

# TrapFall Configuration
# Copy to .env and customize for your environment.

# ── Server ─────────────────────────────────────────────────────────────
# HTTP listen address (default: 0.0.0.0:9090)
TRAPFALL_LISTEN=0.0.0.0:9090

# Log level: trace, debug, info, warn, error (default: info)
RUST_LOG=trapfall=info

# ── Display Timezone ──────────────────────────────────────────────────
# IANA timezone for DISPLAY ONLY (log timestamps + dashboard). All stored
# timestamps remain UTC RFC3339; this never affects data.
# Examples: Asia/Jakarta, America/New_York, Europe/London
# Default: UTC
TRAPFALL_TIMEZONE=Asia/Jakarta

# ── Database ───────────────────────────────────────────────────────────
# Database URL. Supports sqlite: and postgres:// schemes.
# Bare paths default to sqlite: (e.g. /data/trapfall.db → sqlite:/data/trapfall.db)
# Inside Docker, use the volume mount path:
TRAPFALL_DATABASE_URL=sqlite:/data/trapfall.db

# ── Security ───────────────────────────────────────────────────────────
# Set to false for local HTTP development (no HTTPS).
# Production should always be true.
TRAPFALL_SECURE_COOKIE=false

# CORS origins — comma-separated. Empty = allow all (dev only).
# Production example: https://trapfall.example.com
TRAPFALL_CORS_ORIGINS=

# ── Public URL / DSN Host ──────────────────────────────────────────────
# Public host (or full URL) of this TrapFall instance, used to generate DSN
# values for new projects (setup wizard + project create).
#
# Accepts either a bare host (`trapfall.example.com`), a host:port
# (`errors.app.io:3000`), or a full URL with scheme (a `https://`/`http://`
# prefix is stripped automatically before composing the DSN).
#
# Recommended for production — avoids trusting the per-request Host header.
# When unset, TrapFall falls back to the incoming request's Host header
# (handy for local dev via `http://localhost:<port>`).
#
# Examples:
#   TRAPFALL_PUBLIC_URL=trapfall.example.com
#   TRAPFALL_PUBLIC_URL=https://errors.myapp.io
#
# Legacy alias (still supported): TRAPFALL_DSN_HOST
# TRAPFALL_PUBLIC_URL=

# ── Sentry SDK Compatibility ──────────────────────────────────────────
# When using Sentry SDKs, point them to your TrapFall instance:
#
# Python:  sentry_sdk.init(dsn="http://<key>@localhost:9090/0")
# Node.js: Sentry.init({ dsn: "http://<key>@localhost:9090/0" })
# Rust:    sentry::init(("http://<key>@localhost:9090/0", sentry::ClientOptions::default()))
#
# The DSN key is generated per-project via the dashboard.