OpenProject/Update/Docker: Unterschied zwischen den Versionen

Aktuelle Version vom 26. Januar 2026, 11:58 Uhr

OpenProject/Update/Docker

Beschreibung

Aktualisierung einer Compose-basierten OpenProject-Installation durch Anpassen des Image-Tags und Neustart der Services

Hinweis

Upgrade-Pfad beachten: Major-Upgrade nur A.B -> A.B+1. Bei Sprüngen ist eine Zwischenversion erforderlich
Ab OpenProject 16 ist PostgreSQL ≥ 16 Mindestanforderung

Version anpassen

docker-compose.yml

Die Docker-Image-Version muss durch die erforderliche Version ersetzt werden.

services:
  openproject:
    image: openproject/openproject:16.6.2

Backup

Datenbank-Dump

All-in-One-Container

Bei Nutzung des All-in-One-Containers läuft PostgreSQL innerhalb des OpenProject-Containers.

Container-Name ermitteln

docker ps | grep openproject

Dump erstellen

docker exec -it <OP_CONTAINER_NAME> su - postgres -c "pg_dump -d openproject -x -O" > openproject.sql

Der Dump wird über STDOUT auf den Host umgeleitet
Der Container muss laufen
Für automatisierte Backups empfiehlt sich ein Cronjob auf Host-Ebene

Container stoppen und löschen

Im Verzeichnis mit docker-compose.yml

docker compose down

Container hochfahren

docker compose up -d

Datenbank

Bei der Aktualisierung kann OpenProject die Datenbank neu kompilieren, sodass der Start einige Zeit dauern kann und ein weiterer Neustart der Container erforderlich sein kann.

Logs prüfen

docker compose logs -f openproject

Reinigung

Bereinigung nicht verwendeter Docker-Images

docker image prune -a

Anhang

Siehe auch

Dokumentation

Links

Projekt

Weblinks

@@ Zeile 2: / Zeile 2: @@
 == Beschreibung ==
-=== docker-compose.yml anpassen ===
+[[File:openpojectUpdateNote.png|mini|200px|Update-Meldung]]
-Öffnen Sie docker-compose.yml
+Aktualisierung einer Compose-basierten OpenProject-Installation durch Anpassen des Image-Tags und Neustart der Services
-* Ersetzen Sie die Version durch die Version, auf die Sie aktualisieren möchten:
-<syntaxhighlight lang="yaml" highlight="" copy line>
+; Hinweis
+* Upgrade-Pfad beachten: Major-Upgrade nur ''A.B -> A.B+1''. Bei Sprüngen ist eine Zwischenversion erforderlich
+* Ab OpenProject 16 ist PostgreSQL ≥ 16 Mindestanforderung
+=== Version anpassen ===
+; docker-compose.yml
+* Die Docker-Image-Version muss durch die erforderliche Version ersetzt werden.
+<syntaxhighlight lang="yaml" highlight="3" copy line>
 services:
    openproject:
      image: openproject/openproject:16.6.2
+</syntaxhighlight>
+=== Backup ===
+; Datenbank-Dump
+==== All-in-One-Container ====
+Bei Nutzung des All-in-One-Containers läuft PostgreSQL innerhalb des OpenProject-Containers.
+; Container-Name ermitteln
+<syntaxhighlight lang="bash" highlight="1" line copy>
+docker ps | grep openproject
+</syntaxhighlight>
+; Dump erstellen
+<syntaxhighlight lang="bash" highlight="1" line copy>
+docker exec -it <OP_CONTAINER_NAME> su - postgres -c "pg_dump -d openproject -x -O" > openproject.sql
+</syntaxhighlight>
+* Der Dump wird über [[Standard-Datenströme|STDOUT]] auf den Host umgeleitet
+* Der Container muss laufen
+* Für automatisierte Backups empfiehlt sich ein [[Cron|Cronjob]] auf Host-Ebene
+<syntaxhighlight lang="bash" highlight="1" copy>
 </syntaxhighlight>
 === Container stoppen und löschen ===
 Im Verzeichnis mit ''docker-compose.yml''
-<syntaxhighlight lang="bash" highlight="1" copy line>
+<syntaxhighlight lang="bash" highlight="1" copy>
 docker compose down
 </syntaxhighlight>
 === Container hochfahren ===
-<syntaxhighlight lang="bash" highlight="1" copy line>
+<syntaxhighlight lang="bash" highlight="1" copy>
 docker compose up -d
 </syntaxhighlight>
+=== Datenbank ===
 Bei der Aktualisierung kann OpenProject die Datenbank neu kompilieren, sodass der Start einige Zeit dauern kann und ein weiterer Neustart der Container erforderlich sein kann.
-* Wenn das Update innerhalb einer Hauptversion (z.&nbsp;B.&nbsp;16) erfolgt und in ''docker-compose.yml'' genau diese Hauptversion angegeben ist, muss für das Update zunächst die neueste Nebenversion heruntergeladen werden:
-<syntaxhighlight lang="bash" highlight="1" copy line>
+; Logs prüfen
-docker compose pull openproject
+<syntaxhighlight lang="bash" highlight="1" copy>
+docker compose logs -f openproject
 </syntaxhighlight>
-Danach können Sie mit Schritt 2 fortfahren.
+=== Reinigung ===
+; Bereinigung nicht verwendeter Docker-Images
+<syntaxhighlight lang="bash" highlight="1" copy>
+docker image prune -a
+</syntaxhighlight>
 <noinclude>
@@ Zeile 44: / Zeile 81: @@
 <!--
 ; Man-Page
-# [https://manpages.debian.org/stable/procps/pgrep.1.de.html prep(1)]
 ; Info-Pages