.env.example

# ─────────────────────────────────────────────────────────────────────────────
# Comms configuration
#
# Only TWO variables are required: DATABASE_URL and REDIS_URL.
# Everything below the "Required" block is optional.
#
# On Railway you set nothing by hand — see the "Deploy to Railway" guide in the
# README. DATABASE_URL / REDIS_URL are references to the Postgres & Redis
# services; the app secret is generated and stored in the database on first boot;
# the public URL is derived automatically.
#
# For local development: copy this file to .env and point the first two at your
# local Postgres and Redis.
# ─────────────────────────────────────────────────────────────────────────────

# --- Required (only these two) ---
# Postgres connection string
DATABASE_URL=postgresql://postgres:postgres@localhost:5432/comms
# Redis connection string
REDIS_URL=redis://localhost:6379

# --- App secret (optional) ---
# Signs sessions and encrypts integration credentials at rest. If unset, Comms
# generates one and stores it in the database automatically. Set it explicitly
# for production hardening (keeps the encryption key out of the database); use
# the SAME value on the web and worker. Generate with: openssl rand -base64 48
# APP_SECRET=

# --- Public URL ---
# Explicit base URL (no trailing slash). On Railway this is derived from
# RAILWAY_PUBLIC_DOMAIN automatically; set it locally if needed.
# APP_URL=http://localhost:3000

# --- Object storage (optional; enables attachment storage) ---
# Any S3-compatible store: Railway Storage Bucket, Cloudflare R2, MinIO, AWS S3…
# S3_ENDPOINT=https://storage.railway.app
# S3_REGION=auto
# S3_ACCESS_KEY_ID=
# S3_SECRET_ACCESS_KEY=
# S3_BUCKET=comms
# S3_FORCE_PATH_STYLE=true

# --- AI features (optional; enables summaries, suggested replies, auto-triage) ---
# Get a key at https://console.anthropic.com. When unset, AI features are hidden.
# ANTHROPIC_API_KEY=
# Model for AI features (defaults to the latest Claude Opus). Use a smaller model
# (e.g. claude-haiku-4-5) to trade quality for lower cost/latency.
# AI_MODEL=claude-opus-4-8

# --- Deliverability ---
# Minimum milliseconds between outbound sends per iMessage number (anti-throttling).
# SEND_MIN_INTERVAL_MS=800

# --- Email / SMTP (optional; enables magic-link sign-in, invites, notifications) ---
# SMTP_HOST=
# SMTP_PORT=587
# SMTP_USER=
# SMTP_PASSWORD=
# SMTP_FROM="Comms <support@yourdomain.com>"

# --- OAuth / SSO (optional) ---
# GOOGLE_CLIENT_ID=
# GOOGLE_CLIENT_SECRET=
# GITHUB_ID=
# GITHUB_SECRET=

# --- Enterprise Edition (optional) ---
# Unlocks the features in packages/enterprise: billing, enterprise SSO (SAML/OIDC
# + SCIM), and audit log retention/export. Leave unset to run the community
# edition — the shared inbox, ticketing, macros, automations, AI and the
# BlueBubbles bridge are all AGPLv3 and need no key.
# Keys are verified offline against a public key baked into the build, so this
# never phones home. A missing, expired or malformed key disables the paid
# features and nothing else.
# COMMS_LICENSE_KEY=
# Only needed to verify against a non-default issuer (a fork, or staging).
# COMMS_LICENSE_PUBLIC_KEY=

# --- Misc ---
# LOG_LEVEL=info