example.env

# =========================
# Core server configuration
# =========================

# NODE_ENV (optional, default: development)
# NODE_ENV=development

# NODE_PORT (optional, default: 4500)
# NODE_PORT=4500

# REQUEST_BODY_LIMIT (optional, default: 20mb)
# Maximum accepted request body size for JSON and urlencoded payloads.
# Increase if /generate requests include large embedded templates/data.
# REQUEST_BODY_LIMIT=20mb


# ========================
# Database configuration
# ========================

# Required: provide either DATABASE_CONNECTION_STRING OR all discrete DATABASE_* fields.

# DATABASE_CONNECTION_STRING (optional if DATABASE_* fields are provided, no default)
# DATABASE_CONNECTION_STRING=postgres://duouser:duopassword@localhost:5432/duo

# DATABASE_HOSTNAME (required if DATABASE_CONNECTION_STRING is not set, no default)
DATABASE_HOSTNAME=localhost

# DATABASE_PORT (required if DATABASE_CONNECTION_STRING is not set, default: 5432)
DATABASE_PORT=5432

# DATABASE_USER (required if DATABASE_CONNECTION_STRING is not set, no default)
DATABASE_USER=duouser

# DATABASE_PASSWORD (required if DATABASE_CONNECTION_STRING is not set, no default)
DATABASE_PASSWORD=duopassword

# DATABASE_DATABASE (required if DATABASE_CONNECTION_STRING is not set, no default)
DATABASE_DATABASE=duo

# DATABASE_LOG_QUERIES (optional, default: disabled)
# Set to 1 to log SQL queries
# DATABASE_LOG_QUERIES=1


# ==================================
# Dependency / logging configuration
# ==================================

# DEPENDENCY_CONFIG (optional, default: default config)
# Supported values: ess, stfc
# DEPENDENCY_CONFIG=ess

# GRAYLOG_SERVER (optional, no default)
# GRAYLOG_SERVER=it-graylog.esss.lu.se
# GRAYLOG_PORT (optional, no default)
# GRAYLOG_PORT=12201

# LOG_LEVEL (optional, default: info in STFC logger)
# LOG_LEVEL=info


# ==========================
# OpenTelemetry configuration
# ==========================

# OTEL_EXPORTER_OTLP_ENDPOINT (optional, default: disabled)
# OTEL_EXPORTER_OTLP_ENDPOINT="http://localhost:4318/v1/traces"

# OTEL_EXPORTER_OTLP_METRICS_ENDPOINT (optional, default: disabled)
# OTEL_EXPORTER_OTLP_METRICS_ENDPOINT="http://localhost:4318/v1/metrics"

# OTEL_SERVICE_NAME (optional, defaults vary by tracer/metrics module)
# OTEL_SERVICE_NAME=user-office-factory


# =======================
# PDF generation settings
# =======================

# MAX_CONCURRENT_PDF_GENERATIONS (optional, default: 2)
# Suggestions:
# - Built-in Chrome instance: around 2
# - Remote Browserless cluster: depends on Browserless capacity
#   Example: one pod with CONCURRENT=5 and QUEUED=10 => upper bound ~15
# MAX_CONCURRENT_PDF_GENERATIONS=2

# PDF_GENERATION_TIMEOUT (optional, default: 60000 ms)
# PDF_GENERATION_TIMEOUT=60000

# PDF_MAX_RETRIES (optional, default: 3)
# Maximum retry attempts for transient PDF generation failures.
# Retry backoff is exponential: 2s, 4s, 8s, ...
# PDF_MAX_RETRIES=3

# PDF_DEBUG_HTML (optional, default: disabled)
# Set to 1 to write rendered HTML next to generated PDFs
# PDF_DEBUG_HTML=1

# UO_FEATURE_ALLOW_NO_SANDBOX (optional, default: disabled)
# Built-in Chromium mode only (local puppeteer.launch).
# Ignored when using Browserless remote mode (BROWSER_WS_ENDPOINT set).
# Set to 1 to launch Chromium with --no-sandbox.
# UO_FEATURE_ALLOW_NO_SANDBOX=1

# HEADER_LOGO_PATH (optional, no default)
# Custom header logo path for template rendering
# HEADER_LOGO_PATH=/absolute/path/to/logo.png


# ==================================
# Browserless / remote browser mode
# ==================================

# BROWSER_WS_ENDPOINT (optional, default: disabled)
# When set, PDF generation uses remote Browserless instead of local Chromium.
# Example (Docker Compose): ws://browserless:3000
# Example (Local dev + Browserless in Docker): ws://localhost:3010
# Example (Kubernetes): ws://browserless.default.svc.cluster.local:3000
# BROWSER_WS_ENDPOINT=ws://browserless:3000

# FACTORY_BASE_URL (optional, default: http://localhost:<NODE_PORT>)
# Base URL used by browser to fetch static assets (CSS/fonts/images/JS).
# Must be resolvable by the Browserless container.
# Example (Docker Compose): http://factory:4500
# Example (local dev + Browserless in Docker): http://host.docker.internal:4500
# Example (Kubernetes): http://<service-name>.<namespace>.svc.cluster.local:<service-port>
# FACTORY_BASE_URL=http://factory:4500