Self-Hosting
Konfiguration
Jede Stellschraube ist eine Umgebungsvariable in der .env im Repo-Root, geteilt von Docker Compose, der Web-App und den Go-Diensten.
Aktualisiert am 1. Sept. 2026 beta 1 Min. Lesezeit
Datenbank #
| Variable | Standard | Hinweis |
|---|
DATABASE_URL | — | Vollständiger Connection-String. In Produktion leer lassen, dann wird er aus den Teilen unten gebaut. |
POSTGRES_USER POSTGRES_PASSWORD POSTGRES_DB | trackr | Compose provisioniert den db-Dienst daraus. |
POSTGRES_HOST POSTGRES_PORT | localhost 5432 | Compose setzt den Host auf db. |
Routing und Auth #
| Variable | Standard | Hinweis |
|---|
ORIGIN | ungesetzt | Hinter einem Proxy mit Forwarded-Headern ungesetzt lassen. |
PROTOCOL_HEADER HOST_HEADER | x-forwarded-proto x-forwarded-host | Header-Namen, denen die App vertraut. |
XFF_DEPTH | 1 | Anzahl der Proxies davor. |
BETTER_AUTH_SECRET | — | Pflicht. 32+ Zeichen. |
ROOT_EMAIL ROOT_PASSWORD ROOT_NAME | — | Angelegtes Superadmin-Konto. |
E-Mail #
| Variable | Standard |
|---|
EMAIL_FROM | — |
SMTP_HOST | leer = in die Konsole loggen |
SMTP_PORT | 587 |
SMTP_SECURE | false |
SMTP_USER SMTP_PASS | — |
Speicher #
Die STORAGE_*- und S3_*-Variablen stehen unter Docker Compose → Speicher.
Worker #
| Variable | Standard | Hinweis |
|---|
WORKER_CONCURRENCY | 4 | Parallele Jobs pro Worker. |
WORKER_JOB_TIMEOUT | 4m | Frist pro Job. |
WORKER_POLL_INTERVAL | 1s | Fallback-Polling; LISTEN/NOTIFY weckt sofort. |
WORKER_NOTIFY | true | false deaktiviert LISTEN/NOTIFY. |
WORKER_HEARTBEAT WORKER_REAP_AFTER | 30s 5m | Hängende Jobs werden nach dem Reap-Fenster neu eingereiht. |
WORKER_BACKOFF_BASE WORKER_BACKOFF_CAP | 10s 10m | Exponentielles Backoff. |
WORKER_JOB_TYPES | alle | Kommagetrennte Liste, um einen Worker auf Job-Typen festzulegen. |
WORKER_ID | Hostname | Erscheint im Job-Monitor. |
Scheduler #
| Variable | Standard |
|---|
SCHEDULER_POLL_INTERVAL | 5s |
SCHEDULER_BATCH_SIZE | 100 |
SCHEDULER_ID | Hostname |
Webhooks und Push #
| Variable | Standard | Hinweis |
|---|
WEBHOOKS_ENABLED | true | |
WEBHOOK_TIMEOUT | 10s | |
WEBHOOK_ALLOW_PRIVATE_URLS | false | Nur für die Entwicklung. |
PUSH_ENABLED | false | Aktiviert APNs-Zustellung. |
APNS_KEY APNS_KEY_ID APNS_TEAM_ID APNS_BUNDLE_ID APNS_ENV | — | APNs-Zugangsdaten für die iOS-App. |