Settings
Settings live in the .env file. .env.example is the full, commented list. After changing one,
run docker compose up -d to apply it.
Which Compose files run
COMPOSE_FILE, at the top of .env, chooses the files every docker compose command uses, so you never type -f
flags. Leave it as docker-compose.yml on a CPU-only machine, or use the line ending in docker-compose.gpu.yml
with an NVIDIA graphics card. After changing it, run docker compose up -d --build.
The settings you are most likely to change
| Variable | What it does |
|---|---|
CHAT_MODELS | Models the chat picker offers, first one the default. Each must also be installed by the engine (LOCALAI_MODELS, or a config file under localai/) |
TLDR_MODEL | Setting it turns on the one-line TLDR: summaries, written slowly in the background |
WHISPER_URL / WHISPER_MODEL | Transcription; required for audio, which stays hidden until it is set |
THEOLOGICAL_GROUNDING | The tradition chat answers from (stance only, answers stay grounded) |
DEFAULT_TRANSLATIONS / PREFERRED_TRANSLATION | Translations search and chat start with, and the one a verse is shown in |
DEFAULT_INTERLINEARS | Which interlinear a reader sees first (bsb, tahot, tagnt) |
IMAGE_URL / IMAGE_MODELS | Image generation, GPU only and off by default: see Image models |
RERANK_MODEL | An optional model that orders retrieved sources: see Reranker |
AUTH_OIDC_* / AUTH_SECRET / AUTH_URL | Optional sign-in: see Sign-in |
SOURCE_CODE_URL | Where the app's source links point; set it if you serve a changed Bibliup (see the Licence) |
LOCALE | Default interface language (English ships) |
LOG_LEVEL / LOG_FORMAT / OTEL_EXPORTER_OTLP_ENDPOINT / OTEL_EXPORTER_OTLP_HEADERS | Logging, and optional OpenTelemetry export (headers: comma-separated key=value pairs, e.g. an auth token, sent with every export) |
USAGE_RETENTION_DAYS | How long each reader's own usage statistics are kept, in days |
PROFILING_ENABLED | On-demand CPU and heap profiles on port 9464 (see Monitoring) |
Ports
Ports are set in docker-compose.yml. Comment out a ports line to free a clash.
| Port | What |
|---|---|
3000 | The app |
3001 | The OpenAI /v1 and MCP /mcp endpoints (see Use it from other apps) |
9464 | Metrics and API reference |
9200 | Elasticsearch |
27017 | MongoDB |
8090 | The AI engine (localhost only) |
8081 | Landing page (on every network address: comment out its ports line on a private install) |
6274 | MCP Inspector (localhost only) |
16686 | Jaeger, GPU only (localhost only) |