Deployment
OpenTremor Core ships as a set of Docker images — there is no other distribution format. Choose the topology that matches your infrastructure.
| Topology | Best for |
|---|---|
| Docker (Single-VM) | One host, no Kubernetes cluster — Compose + HAProxy + Let’s Encrypt |
| Helm chart | Kubernetes — HPA, Ingress, Secret management |
Runtime dependencies
Section titled “Runtime dependencies”| Dependency | Required | Notes |
|---|---|---|
| Docker + Compose (or a Kubernetes cluster) | Yes | The only supported install path |
| MongoDB 7.0+ | Recommended | Not required when storage.backend: memory |
Configuration
Section titled “Configuration”Every topology shares the same YAML configuration file. See Full Reference for every field.
In any real (multi-replica or restart-tolerant) deployment, set JWT_SECRET and
LLM_CREDENTIAL_KEY explicitly via environment variable/Secret — left unset, they default
to a random per-process value, which invalidates every session and makes stored LLM
credentials unreadable across restarts. See
Environment Variables. If using the
GitHub App integration with the platform’s own shared App, set it via
PATCH /admin/settings after first boot instead — github isn’t read from the config file
or env at all, see
Platform settings.