Configuration Reference

All services are configured via environment variables. No configuration files.

Error Tracker

Variable	Required	Default	Description
API_KEY	Yes	–	API key for authentication
DATABASE_PATH	No	./data/errors.db	SQLite database path
LOG_LEVEL	No	info	error, warn, info, debug
RETENTION_DAYS	No	90	Days before resolved errors are deleted
SMTP_HOST	No	–	SMTP server host for email alerts
SMTP_PORT	No	25	SMTP server port (use 587 for STARTTLS)
SMTP_USERNAME	No	–	SMTP username for authentication
SMTP_PASSWORD	No	–	SMTP password for authentication
SMTP_FROM	No	errors@example.com	Sender email for alerts
ALERT_EMAILS	No	–	Comma-separated alert recipients

Log Viewer

Variable	Required	Default	Description
API_KEY	Yes	–	API key for authentication
DATABASE_PATH	No	./data/logs.db	SQLite database path
CONTAINERS	No	(empty = all)	Comma-separated container names to monitor
LOG_SOURCES	No	/var/lib/docker/containers	Docker containers directory
MAX_ENTRIES	No	100000	Max log entries (ring buffer)
POLL_INTERVAL	No	2	Seconds between log file polls
TAIL_BUFFER	No	65536	Bytes to read from file end on first run
LOG_LEVEL	No	info	error, warn, info, debug

Metrics Collector

Variable	Required	Default	Description
API_KEY	Yes	–	API key for authentication
DATABASE_PATH	No	./data/metrics.db	SQLite database path
RETENTION_RAW	No	1	Hours to keep raw data
RETENTION_MINUTE	No	24	Hours to keep minute aggregates
RETENTION_HOURLY	No	30	Days to keep hourly aggregates
AGGREGATION_INTERVAL	No	60	Seconds between aggregation runs
LOG_LEVEL	No	info	error, warn, info, debug

Browser Relay

Variable	Required	Default	Description
ADMIN_API_KEY	Yes	–	API key for admin endpoints
ERROR_TRACKER_URL	Yes	–	Internal error tracker URL
ERROR_TRACKER_API_KEY	Yes	–	Error tracker API key
METRICS_COLLECTOR_URL	Yes	–	Internal metrics collector URL
METRICS_COLLECTOR_API_KEY	Yes	–	Metrics collector API key
DATABASE_PATH	No	./data/browser-relay.db	SQLite database path
CORS_ORIGINS	No	–	Comma-separated allowed origins
MAX_BODY_SIZE	No	65536	Max request body in bytes
RATE_LIMIT	No	300	Requests per minute per key
DSN_KEYS	No	–	Seed DSN keys: project:key,project2:key2
RETENTION_DAYS	No	90	Days to keep source maps
LOG_LEVEL	No	info	error, warn, info, debug

secrets.env template

# Required - generate with: openssl rand -hex 16
ERROR_TRACKER_API_KEY=<random-32-char-string>
LOG_VIEWER_API_KEY=<random-32-char-string>
METRICS_COLLECTOR_API_KEY=<random-32-char-string>
BROWSER_RELAY_ADMIN_API_KEY=<random-32-char-string>

# Optional
# CORS_ORIGINS=https://yourdomain.com,https://www.yourdomain.com
# CONTAINERS=my_app,my_worker
# LOG_LEVEL=info

# DSN key seeding (optional, browser relay)
# DSN_KEYS=my-app:my-dsn-key,other-app:other-key

# SMTP email alerts (optional, STARTTLS auto-detected)
# SMTP_HOST=smtp.example.com
# SMTP_PORT=587
# SMTP_USERNAME=
# SMTP_PASSWORD=
# SMTP_FROM=errors@example.com
# ALERT_EMAILS=admin@example.com