Zum Inhalt springen
Esc
↑↓navigieren↵öffnen⌘Jvorschau
Auf dieser Seite

Installation und Betrieb

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

Repository auschecken

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

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.

DNS

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

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. 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.
  • 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 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.