.env.example

# DistTaskQueue environment variables
# Copy to .env for local overrides; .env is gitignored.
# See docs/OPERATIONS.md §2 for detailed documentation.

# --- Shared (all binaries) ---

# Postgres connection string.
DATABASE_URL=postgres://dtq:dtq@localhost:5432/dtq?sslmode=disable

# Redis connection string.
REDIS_URL=redis://localhost:6379/0

# Base64-encoded 32-byte AES-256-GCM key for OAuth token encryption.
TOKEN_ENCRYPTION_KEY=<base64 of 32 random bytes — openssl rand -base64 32>

# Google OAuth client credentials. Create a Desktop OAuth 2.0 Client at console.cloud.google.com.
GOOGLE_OAUTH_CLIENT_ID=<your-client-id>
GOOGLE_OAUTH_CLIENT_SECRET=<your-client-secret>

# --- api (cmd/api) ---

# HTTP listen address.
API_ADDR=:8080

# --- worker (cmd/worker) ---

# Shared data volume. Holds mime/, pdf/, attachments/, meta/ subdirectories.
DATA_DIR=/data

# Gotenberg URL for PDF rendering. Used by render-worker stage only.
GOTENBERG_URL=http://gotenberg:3000

# Drive folder ID. Leave empty to use "My Drive" root.
DRIVE_ROOT_FOLDER_ID=

# Slash-delimited folder path under DRIVE_ROOT_FOLDER_ID.
DRIVE_ROOT_PATH=

# BLPOP timeout when waiting for a queued job (seconds).
WORKER_POP_TIMEOUT_SEC=30

# Heartbeat TTL before the sweeper considers a worker dead (seconds).
WORKER_HEARTBEAT_TTL_SEC=15

# Interval for worker heartbeat writes (seconds).
WORKER_HEARTBEAT_INTERVAL_SEC=5

# --- sweeper (cmd/sweeper) ---

# How long a queued job without errors can sit before re-queuing (seconds).
STALE_QUEUED_THRESHOLD_SEC=60

# --- scheduler (cmd/scheduler) ---

# Gmail History API poll interval (seconds).
SCHEDULER_POLL_INTERVAL_SEC=60

# Secondary backfill loop interval (seconds). Set to 0 to disable.
BACKFILL_INTERVAL_SEC=3600

# How far back messages.list looks during backfill (hours).
BACKFILL_WINDOW_HOURS=24