---
title: Installation und Betrieb
description: Docker-Compose-Stack, Sidecars, Konfiguration über Umgebungsvariablen.
---

Lagewerk läuft als Docker-Compose-Stack. Die Datei `docker-compose.yml` im Repository beschreibt den
Produktionsbetrieb hinter dem Reverse-Proxy Traefik mit Let's-Encrypt-Zertifikaten.

## Bestandteile

| Dienst | Aufgabe |
| --- | --- |
| `backend` | Go-Server: API, WebSocket, Hintergrundaufgaben, Datenbank-Migrationen beim Start |
| `frontend` | Die Browser-Oberfläche (statische Dateien über nginx) |
| `postgres` | Datenbank (PostgreSQL 18) |
| `rustfs` | S3-kompatibler Objektspeicher für Anhänge und Dokumente |
| `gotenberg` | Erzeugt PDF-Berichte und Kartenexporte |
| `photon` | Geocoder für Adressvorschläge (optional, wartet ohne Index) |
| `handbuch` | Dieses Handbuch |
| `traefik` | TLS-Terminierung und Routing |

Es wird genau **eine** Backend-Instanz betrieben. Echtzeit-Verteilung, Rate-Limits und Caches
liegen im Speicher dieses Prozesses.

## Erstinstallation

1. **Repository auschecken**

    Auf dem Server das Repository klonen. Die Images werden aus dem Checkout gebaut.

2. **Konfiguration anlegen**

    `.env.example` nach `.env` kopieren und mindestens `DOMAIN`, `HANDBUCH_DOMAIN`,
    `ACME_EMAIL`, `FRONTEND_ORIGINS`, `DB_PASSWORD`, `JWT_SECRET`, `S3_SECRET_KEY` und
    `ADMIN_PASSWORD` setzen. Steht dort noch ein Platzhalter `CHANGE_ME…`, startet das Backend
    nicht.

3. **DNS**

    `DOMAIN` und `HANDBUCH_DOMAIN` müssen auf den Server zeigen, damit Let's Encrypt die
    Zertifikate ausstellen kann.

4. **Starten**

    `docker compose up -d --build`. Das Backend legt beim ersten Start das Schema an und den
    Administrator aus `ADMIN_USERNAME`/`ADMIN_PASSWORD`.

## Wichtige Einstellungen

Alle Schlüssel mit Erläuterung stehen in [`.env.example`](https://git.wannenmacher.org/lagewerk/server/-/blob/main/.env.example). Besonders wichtig:

- `SECRETS_KEY` (mindestens 32 Zeichen) verschlüsselt Zugangsdaten von Anbindungen und
  WMS-Diensten. Leer bleibt die Anbindungsverwaltung abgeschaltet.
- `SMTP_*` und `IMAP_*` werden beim Start einmalig als E-Mail-Postfach übernommen, danach pflegen
  Sie Postfächer in der Verwaltung, siehe
  [E-Mail](/administration/email).
- `EGRESS_ALLOWED_NETS` gibt interne Netze frei, die das Backend für Kartenquellen, WMS oder
  Anbindungen erreichen darf. Standardmäßig sind interne Adressen gesperrt.
- `STATUS_HISTORY_RETENTION_DAYS` und `POSITION_HISTORY_RETENTION_HOURS` begrenzen die
  Aufbewahrung von Status- und Positionsdaten. Die Positionsdaten bestimmen auch, wie weit die
  [Zeitachse](/anwender/lagen/lagekarte-und-statistik#zeitachse) Fahrzeuge zeigt. Den Verlauf der
  Lagekarten-Zeichnungen löscht das System erst mit seiner Lage bzw. seinem Einsatz.
- `TZ` legt die Zeitzone für Tagesgrenzen (z. B. die UHS-Tagesliste „heute“) und die Uhrzeiten in
  Berichten fest. Standard `Europe/Berlin`.
- `ERROR_REPORTING_ENABLED` meldet Fehler von Backend und Frontend an den GlitchTip-Dienst des
  Herstellers (`glitchtip.wannenmacher.org`). Übertragen werden Fehlertext, technischer Stack,
  Version, Routenmuster, Hostname der Installation und die interne Benutzer-ID, keine Header und
  URLs. Ein Fehlertext kann
  einzelne Feldwerte enthalten. **Standardmäßig eingeschaltet**, `false` schaltet es ab. Das Gateway
  meldet Plugin-Panics und Startfehler ohne Benutzerbezug; dort setzen Sie dieselbe Variable.
  Vom Backend gehen außerdem die Antwortzeiten von 10 % der Anfragen mit Routenmuster und
  Benutzer-ID an denselben Dienst; WebSockets und Datei-Transfers sind davon ausgenommen. Das
  Frontend meldet für 10 % der Seitenaufrufe Ladezeiten und Web Vitals, ebenfalls mit Routenmuster
  und Benutzer-ID. `PERFORMANCE_MONITORING_ENABLED=false` schaltet nur diese Zeiten ab,
  mit `ERROR_REPORTING_ENABLED=false` wird gar nichts gesendet.
- `LOG_REPORTING_ENABLED=true` sendet zusätzlich die Log-Zeilen des Backends an denselben Dienst
  (ohne Access-Log). Standardmäßig ausgeschaltet.
- Das Backend-Log enthält nur IDs und technische Angaben. Einsätze erscheinen mit Nummer und ID,
  Anbindungen mit Typ und ID; Client-IPs und Query-Parameter werden nicht protokolliert.

Einstellungen, die zur Laufzeit gepflegt werden (zum Beispiel Kartenquellen und der
Start-Ausschnitt der Karte), stehen nicht in `.env`, sondern in der Verwaltung.

## Aktualisieren

Neuen Stand auschecken und `docker compose up -d --build` ausführen. Datenbank-Migrationen
laufen beim Start des Backends automatisch.
