.env.example

# HeadlessX v2.1.0
# Local development environment

# Database — Docker Postgres only (no Supabase)
DATABASE_URL="postgresql://headlessx:headlessx@localhost:35432/headlessx"

# API server
PORT=38473
HOST=0.0.0.0
NODE_ENV=development

# Required security
# Used by the Next.js dashboard server to authenticate against the API.
DASHBOARD_INTERNAL_API_KEY=replace-with-a-long-random-string

# Used to encrypt stored credentials at rest.
CREDENTIAL_ENCRYPTION_KEY=replace-with-a-different-long-random-string

# Queue and Redis
REDIS_URL=redis://localhost:36379

# Search providers
TAVILY_API_KEY=
EXA_API_KEY=

# Local engines
YT_ENGINE_URL=http://localhost:38090
YT_ENGINE_PORT=38090
YT_ENGINE_TIMEOUT_MS=45000
YT_ENGINE_TEMP_DIR=./tmp/yt-engine
YT_ENGINE_JOB_TTL_HOURS=12

HTML_TO_MARKDOWN_SERVICE_URL=http://localhost:38081
HTML_TO_MARKDOWN_PORT=38081
HTML_TO_MARKDOWN_TIMEOUT_MS=60000

# Browser and stealth defaults are managed in the dashboard settings UI.

# Web dashboard
WEB_PORT=34872
NEXT_PUBLIC_API_URL=http://localhost:38473

# Set this for Docker or custom internal networking.
# INTERNAL_API_URL=http://localhost:38473

# Set this only when the dashboard is hosted on a custom origin.
# FRONTEND_URL=https://dashboard.example.com