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_*undIMAP_*werden beim Start einmalig als E-Mail-Postfach übernommen, danach pflegen Sie Postfächer in der Verwaltung, siehe E-Mail.EGRESS_ALLOWED_NETSgibt interne Netze frei, die das Backend für Kartenquellen, WMS oder Anbindungen erreichen darf. Standardmäßig sind interne Adressen gesperrt.STATUS_HISTORY_RETENTION_DAYSundPOSITION_HISTORY_RETENTION_HOURSbegrenzen 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.TZlegt die Zeitzone für Tagesgrenzen (z. B. die UHS-Tagesliste „heute“) und die Uhrzeiten in Berichten fest. StandardEurope/Berlin.ERROR_REPORTING_ENABLEDmeldet 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,falseschaltet 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=falseschaltet nur diese Zeiten ab, mitERROR_REPORTING_ENABLED=falsewird gar nichts gesendet.LOG_REPORTING_ENABLED=truesendet 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.