Voraussetzungen

parcours kann aus dem Quellcode oder über ein Container-Image betrieben werden. Nur der Betrieb über das Container-Images ist getestet und daher offiziell unterstützt. Wir empfehlen die Verwendung von podman als Container-Runtime.

Darüber hinaus empfehlen wir für den Betrieb von parcours die Anbindung an eine PostgreSQL-Datenbank und einen Redis-kompatiblen Server wie ValKey, falls kollaboratives Arbeiten unterstützt werden soll.

Hinweise

Zum Container-Image

Wir veröffentlichen Docker- und Podman-kompatible Container-Images für parcours.

Ein stabiles Release-Image findest du unter:

git-registry.hack-hro.de:443/rokoli/parcours:latest

Ein instabiles Rolling-Release-Image findest du unter:

git-registry.hack-hro.de:443/rokoli/parcours:rolling

Wir veröffentlichen auch Container-Images für jede getaggte Version. Eine Liste aller Container-Images findest du in der Container Image Registry.

Administrator:innen sollten ein Volume oder einen Dateisystempfad unter /var/lib/parcours einbinden, welches als Speicherort für dynamische Daten verwendet wird. Die Daten werden mit uid/gid 220 / 220 gespeichert.

Zur Datenbank

parcours unterstützt offiziell PostgreSQL. Andere Datenbanken sind ebenfalls möglich werden aber nicht aktiv getestet.

Wir empfehlen, dass bei der Erstellung der Datenbank eine entsprechende Collation eingestellt wird, die natural sort nutzt, damit Felder wie Drucksache den Erwartungen der Nutzer:innen entsprechen sortiert werden.

Für PostgreSQL eigenen sich die ICU-Sortierung. Eine beispielhafte Konfiguration ist in der docker/db.Dockerfile Datei unter den POSTGRES_INITDB_ARGS zu sehen.

Zum Webserver

Der Betrieb ist nur mit NGINX getestet.

Eine Beispielkonfiguration findet sich unter docker/nginx-app.conf und docker/nginx-server.conf.

Falls die Funktion zum kollaborativen Arbeiten verwendet werden soll, ist besonderes Augenmerk auf eine funktionierende Websocket-Konfiguration zu legen.