dragoman 0.4.1

Server for scholarly metadata in commonmeta format stored in a SQLite database.
# dragoman environment variables
# Copy to /etc/dragoman/env and set chmod 640, chown root:dragoman
# All variables are optional unless noted.

# ── Server ────────────────────────────────────────────────────────────────────

# TCP port to listen on (plain HTTP, or HTTP redirect when --domain is set).
PORT=3456

# ── Database ──────────────────────────────────────────────────────────────────

# Path to the local commonmeta SQLite3 database.
# Platform defaults:
#   macOS  → ~/Library/Application Support/commonmeta/commonmeta.sqlite3
#   Linux  → /var/lib/commonmeta/commonmeta.sqlite3
#COMMONMETA_DB=/var/lib/commonmeta/commonmeta.sqlite3

# Path to the dragoman cache database (stores API fallback results).
# Platform defaults:
#   macOS  → ~/Library/Application Support/commonmeta/cache.sqlite3
#   Linux  → /var/lib/commonmeta/cache.sqlite3
#DRAGOMAN_CACHE_DB=/var/lib/dragoman/cache.sqlite3

# ── TLS ───────────────────────────────────────────────────────────────────────

# Domain name for HTTPS.
#   localhost        → HTTPS via mkcert (local development)
#   <public domain>  → HTTPS via Let's Encrypt ACME (production)
#   (unset)          → plain HTTP on 127.0.0.1 (reverse proxy mode)
#DRAGOMAN_DOMAIN=commonmeta.org

# ACME contact email — required when DRAGOMAN_DOMAIN is a public hostname.
#DRAGOMAN_EMAIL=admin@example.org

# Directory to store ACME/mkcert certificates between restarts.
# Platform defaults:
#   macOS  → ~/Library/Application Support/dragoman/acme
#   Linux  → /var/lib/dragoman/acme
#DRAGOMAN_ACME_CACHE=/var/lib/dragoman/acme

# HTTPS port when DRAGOMAN_DOMAIN is set.
# Defaults: localhost → 3456, public domain → 443
#DRAGOMAN_TLS_PORT=443

# Set to any non-empty value to use the Let's Encrypt staging environment.
# Use while testing to avoid rate limits; remove for production.
#DRAGOMAN_ACME_STAGING=

# ── Process ───────────────────────────────────────────────────────────────────

# Path for the PID file written by `dragoman start` and read by `dragoman stop`.
#DRAGOMAN_PID_FILE=/var/run/dragoman.pid

# ── Telemetry ─────────────────────────────────────────────────────────────────

# VictoriaLogs OTLP/HTTP endpoint. When unset, logs go to stdout only.
#DRAGOMAN_VIKTORIALOGS_URL=http://localhost:9428/insert/opentelemetry/v1/logs

# Comma-separated IPs allowed to scrape /metrics (Prometheus format).
# When unset, the /metrics route is not registered.
#DRAGOMAN_METRICS_ALLOW=127.0.0.1

# ── Logging ───────────────────────────────────────────────────────────────────

# tracing-subscriber log filter. Use dragoman=debug for per-request cache hits.
RUST_LOG=dragoman=info