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 1: / Zeile 1: @@
-== Update ==
+'''OpenProject/Update/Docker'''
-. Öffnen Sie docker-compose.yml. Ersetzen Sie die Version durch die Version, auf die Sie aktualisieren möchten:
+== Beschreibung ==
+[[File:openpojectUpdateNote.png|mini|200px|Update-Meldung]]
+Aktualisierung einer Compose-basierten OpenProject-Installation durch Anpassen des Image-Tags und Neustart der Services
-<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:
@@ Zeile 9: / Zeile 18: @@
 </syntaxhighlight>
-. Container stoppen und löschen (im Verzeichnis mit docker-compose.yml)
+=== 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>
-<syntaxhighlight lang="bash" highlight="1" copy line>
+=== Container stoppen und löschen ===
+Im Verzeichnis mit ''docker-compose.yml''
+<syntaxhighlight lang="bash" highlight="1" copy>
 docker compose down
 </syntaxhighlight>
-. Container mit compose up hochfahren
+=== Container hochfahren ===
+<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.
-<syntaxhighlight lang="bash" highlight="1" copy line>
+; Logs prüfen
-docker compose up -d
+<syntaxhighlight lang="bash" highlight="1" copy>
+docker compose logs -f openproject
 </syntaxhighlight>
-* 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.
+=== Reinigung ===
+; Bereinigung nicht verwendeter Docker-Images
+<syntaxhighlight lang="bash" highlight="1" copy>
+docker image prune -a
+</syntaxhighlight>
 <noinclude>
@@ Zeile 36: / Zeile 81: @@
 <!--
 ; Man-Page
-# [https://manpages.debian.org/stable/procps/pgrep.1.de.html prep(1)]
 ; Info-Pages