OpenProject als Container mit eigenem Backup OpenProject im eigenen Re­chen­zen­t­rum sicher betreiben

Von Thomas Joos 8 min Lesedauer

OpenProject läuft als Paket, als Docker-Compose-Stack oder per Helm auf Kubernetes. Die Wahl hängt am Betriebssystem, an der Nutzerzahl und an der Plattform im Rechenzentrum. Welche Einstellungen vor dem ersten Start gesetzt sein sollten, wie Active Directory die Konten liefert und wie Backup, Restore und Updates ablaufen.

Der Betrieb von OpenProject im eigenen Rechenzentrum umfasst mehr als die Installation. Benutzerverwaltung, Datensicherung, Wiederherstellung und regelmäßige Updates gehören ebenfalls zur Administration.(Bild: ©  kiri - stock.adobe.com)
Der Betrieb von OpenProject im eigenen Rechenzentrum umfasst mehr als die Installation. Benutzerverwaltung, Datensicherung, Wiederherstellung und regelmäßige Updates gehören ebenfalls zur Administration.
(Bild: © kiri - stock.adobe.com)

Seit dem 30.09 2026 ist „Project Online“ abgeschaltet. Am 28.03 2029 stellt „Atlassian Jira Data Center“ auf Nur-Lesen um. OpenProject hält die Projektdaten dagegen auf eigenen Servern.

OpenProject lässt sich auf zwei Arten betreiben: als Installationspaket direkt auf einem Linux-Server oder in Containern. Die Pakete gibt es für Server mit x86-64-Prozessoren von Intel und AMD. Für „Ubuntu 22.04“, „Debian 12“ und „RHEL 9“ pflegt OpenProject die Pakete ungefähr bis zum zweiten Quartal 2027. Für das neuere Ubuntu 24.04 plant der Hersteller keine Pakete mehr, und einige künftige Funktionen will er nur noch in den Docker-Containern ausliefern. Neue Installationen sollten deshalb von Anfang an mit Docker Compose oder Kubernetes arbeiten. Die Container laufen auf x86-64-Servern ebenso wie auf Servern mit ARM-Prozessoren (ARM64).

Seit Version 16.0.0 unterstützt OpenProject offiziell „PostgreSQL“ ab Version 16. Eine vorhandene externe Datenbank braucht zusätzlich die Erweiterungen pg_trgm, btree_gist und unaccent.

Unter “Users timeline” zeigt der Ressourcenplaner von OpenProject die gebuchten Stunden je Mitarbeiter für die Woche vom 14. bis 20. September und markiert überbuchte Konten mit einem roten Warnsymbol.(Bild:  Screenshot / Thomas Joos)
Unter “Users timeline” zeigt der Ressourcenplaner von OpenProject die gebuchten Stunden je Mitarbeiter für die Woche vom 14. bis 20. September und markiert überbuchte Konten mit einem roten Warnsymbol.
(Bild: Screenshot / Thomas Joos)

Die Zahl aktiver Nutzer bestimmt die Hardware

Ein Server für bis zu 200 Nutzer kommt mit einem Quad-Core-Prozessor ab 2 GHz, 4.096 MB Arbeitsspeicher und 20 GB Plattenplatz aus. Für 500 aktive Nutzer sieht OpenProject acht Kerne, 8 GB RAM, vier Web-Worker, zwei Hintergrund-Worker und 40 GB Platte vor. Bei 1.500 Nutzern steigen die Werte auf 16 Kerne, 16 GB RAM, acht Web-Worker, vier Hintergrund-Worker und 80 GB.

In seinen Beispielkonfigurationen rechnet OpenProject die Datenbank getrennt, für rund 500 Nutzer mit 2 bis 4 CPU und 8 GiB neben einem Anwendungsserver mit 4 CPU und 8 GB RAM. Mehrere Anwendungsserver teilen sich eine externe Datenbank, Memcached und einen Dateispeicher, zum Beispiel per NFS.

Der Paketassistent richtet PostgreSQL und Apache ein

Für vorhandene Server mit Ubuntu 22.04 bindet der Administrator den Signaturschlüssel und die Paketquelle der Version 17 ein und installiert das Paket.

sudo curl -fsSL "https://packages.openproject.com/srv/deb/opf/openproject/gpg-key.gpg" -o /usr/share/keyrings/openproject.gpg

sudo curl -fsSL "https://packages.openproject.com/srv/opf/openproject/stable/17/installer/ubuntu/22.04.list" -o /etc/apt/sources.list.d/openproject.list

sudo apt-get update && sudo apt-get install openproject

sudo openproject reconfigure

Der Assistent installiert auf Wunsch einen lokalen PostgreSQL-Server oder nutzt eine vorhandene Datenbank, richtet „Apache“ mit TLS ein und fragt nach Memcached und Hostname. Die Antworten speichert er in /etc/openproject/installer.dat, aus der ein späteres openproject configure sie ohne Rückfrage übernimmt.

Docker Compose verteilt OpenProject auf neun Container

Die Compose-Installation beginnt mit dem offiziellen Repository im Zweig stable/17. Der Administrator klont es, kopiert die Beispieldatei .env.example nach .env und übergibt das Datenverzeichnis an die Benutzer-ID 1000.

git clone https://github.com/opf/openproject-docker-compose.git --depth=1 --branch=stable/17 openproject

cp .env.example .env

sudo mkdir -p /var/openproject/assets && sudo chown 1000:1000 -R /var/openproject/assets

docker compose up -d --build --pull always

Die Datei docker-compose.yml startet die Dienste db, cache, proxy, web, worker, cron, seeder, autoheal und hocuspocusin eigenen Containern. Der Dienst hocuspocus ermöglicht gemeinsames Bearbeiten von Dokumenten.

Vor dem ersten Start sollte die .env-Datei vollständig sein, da sie mit POSTGRES_VERSION=17 die Datenbankversion und mit PORT=127.0.0.1:8080 die lokale Bindung festlegt. Fehlt POSTGRES_VERSION, startet die Compose-Datei noch postgres:13. Den Wert SECRET_KEY_BASE erzeugt der Administrator mit head /dev/urandom | tr -dc A-Za-z0-9 | head -c 32 und behandelt ihn wie ein Kennwort, denn jede spätere Änderung macht alle Sitzungen und gemerkten Zwei-Faktor-Tokens ungültig. Die erste Anmeldung läuft mit "admin" und "admin". Eigene Anpassungen gehören in die Datei docker-compose.override.yml, die ein git pull im Unterschied zur docker-compose.yml unverändert lässt.

Jetzt Newsletter abonnieren

Täglich die wichtigsten Infos zu RZ- und Server-Technik

Mit Klick auf „Newsletter abonnieren“ erkläre ich mich mit der Verarbeitung und Nutzung meiner Daten gemäß Einwilligungserklärung (bitte aufklappen für Details) einverstanden und akzeptiere die Nutzungsbedingungen. Weitere Informationen finde ich in unserer Datenschutzerklärung. Die Einwilligungserklärung bezieht sich u. a. auf die Zusendung von redaktionellen Newslettern per E-Mail und auf den Datenabgleich zu Marketingzwecken mit ausgewählten Werbepartnern (z. B. LinkedIn, Google, Meta).

Aufklappen für Details zu Ihrer Einwilligung

Ein Reverse Proxy terminiert TLS vor dem Stack

Mit PORT=127.0.0.1:8080 in der .env nimmt nur der vorgeschaltete Reverse Proxy Verbindungen an und terminiert TLS. Die Compose-Datei allein bindet Port 8080 an 0.0.0.0 und macht OpenProject von außen erreichbar. Für den Produktivbetrieb empfiehlt es sich, OPENPROJECT_HTTPS=true zu setzen und den Hostnamen in OPENPROJECT_HOST__NAME einzutragen.

Der Kollaborationsserver erwartet eine WebSocket-Verbindung unter wss://<Hostname>/hocuspocus, die der Reverse Proxy auf diesem Pfad durchreichen sollte. Das Standardgeheimnis OVERRIDE_ME_PLEASE ersetzt der Administrator über COLLABORATIVE_SERVER_SECRET. Arbeitet der mitgelieferte Caddy als äußerer Proxy, reicht er X-Forwarded-Header ungeprüft weiter. Abhilfe schafft ein Eintrag unter trusted_proxies im Caddyfile, der nur die bekannten Proxys zulässt.

Health Checks und Autoheal überwachen die Dienste

Der Web-Container prüft sich alle 10 Sekunden selbst über den Pfad /health_checks/default. Schlägt diese Prüfung fehl, startet der Dienst autoheal den Web-Container neu, der dafür mit dem Label autoheal markiert ist. Nach dem Start des Stacks lässt autoheal dem Container 600 Sekunden Anlaufzeit. Für das Monitoring stellt OpenProject weitere Endpunkte bereit, darunter /health_checks/database für die Datenbank, /health_checks/worker für die Hintergrundjobs und /health_checks/worker_backed_up für einen Rückstau, der mehr Worker verlangt.

Den Sammelendpunkt /health_checks/all sollte nur das Monitoring abfragen. Für Container- und Pod-Prüfungen genügt /health_checks/default. Ratsam ist zudem, den Zugriff auf die Endpunkte am Reverse Proxy auf das Monitoring-Netz zu beschränken.

Das Helm-Chart verteilt OpenProject auf Kubernetes

Für Kubernetes stellt OpenProject ein signiertes Helm-Chart bereit, das auf Wunsch PostgreSQL und Memcached mit einrichtet.

helm repo add openproject https://charts.openproject.org

helm repo update

helm upgrade --create-namespace --namespace openproject --install openproject openproject/openproject

Das Chart erfüllt mit den Standardwerten das Profil "restricted" der Kubernetes Pod Security Standards. Für Anhänge im Dateisystem verlangt es Volumes mit ReadWriteMany, da mehrere Pods gleichzeitig schreiben. Alternativ speichert ein S3-kompatibler Objektspeicher die Anhänge, wenn persistence.enabled auf false und s3.enabled auf true steht. Der Parameter rustfs.bundled startet einen einzelnen RustFS-Knoten als S3-Speicher, idealerweise nur für einen Schnellstart. Chart 13.13.1 liefert OpenProject 17.9.1 aus und führt die Datenbankmigration in einem eigenen Init-Container aus.

Terraform und Ansible rollen die Konfiguration aus

Das Helm-Chart nimmt über den Eintrag environment jede Umgebungsvariable entgegen, die OpenProject kennt. Die gesamte Konfiguration steht damit in einer values.yaml im Git-Repository. Terraform installiert das Chart mit der Ressourcehelm_release des Helm-Providers, deren Attribut atomic eine fehlgeschlagene Installation wieder entfernt.

resource "helm_release" "openproject" {

name = "openproject"

repository = "https://charts.openproject.org"

chart = "openproject"

version = "13.13.1"

namespace = "openproject"

create_namespace = true

atomic = true

values = [file("values.yaml")]

}

Für den Compose-Stack übernimmt Ansible den Rollout mit dem Modul community.docker.docker_compose_v2. Es setzt das Compose-Plugin ab Version 2.18.0 voraus. Die .env-Datei sollte das Playbook vorher als Vorlage aus der Versionsverwaltung verteilen.

- name: OpenProject-Stack starten

community.docker.docker_compose_v2:

project_src: /opt/openproject

pull: always

build: always

state: present

Active Directory liefert Konten und Gruppen

Die Verbindung zum Verzeichnis richtet ein Administrator unter “Administration” -> “Authentication” -> “LDAP connections” ein. OpenProject empfiehlt STARTTLS. Dabei baut OpenProject die Verbindung auf Port 389 auf und schaltet sie danach auf TLS um.

Active Directory beherrscht dieses Verfahren ebenso wie LDAPS auf Port 636, das die Verbindung von Beginn an verschlüsselt. Beide Wege setzen ein Serverzertifikat auf jedem Domänencontroller voraus. Ein Simple Bind, also die Anmeldung mit Benutzername und Kennwort ohne Verschlüsselung, sollte im Produktivbetrieb ausgeschlossen sein. Neue Domänen unter Windows Server 2025 lehnen ihn bereits standardmäßig ab. Für die Suche braucht OpenProject einen Systembenutzer mit Leserechten unterhalb der Base DN.

Als Login dient im Active Directory zum Beispiel sAMAccountName, der Anmeldename mit höchstens 20 Zeichen. Ein Filter nach RFC 4515 grenzt die Konten auf eine Gruppe ein. Ein Filter mit memberof erfasst nur direkte Mitglieder. Mit der Regel LDAP_MATCHING_RULE_IN_CHAIN durchsucht Active Directory auch verschachtelte Gruppen.

(memberof:1.2.840.113556.1.4.1941:=CN=OpenProject,OU=Rollen,OU=Gruppen,DC=intern)

Name, Mail und Login gleicht ein Hintergrundjob alle 24 Stunden ab, wobei OpenProject mit OPENPROJECT_LDAP__USERS__SYNC__STATUS=true zusätzlich alle Konten sperrt, die im Verzeichnis fehlen. Die Synchronisierung von LDAP-Gruppen setzt die Enterprise Edition voraus.

Der Jira Migrator liest im Import-Vorgang Nummer 2 nacheinander Konfiguration, Vorgänge, Benutzer und Projekte aus Jira und legt sie in der eigenen OpenProject-Instanz an.(Bild:  Screenshot / Thomas Joos)
Der Jira Migrator liest im Import-Vorgang Nummer 2 nacheinander Konfiguration, Vorgänge, Benutzer und Projekte aus Jira und legt sie in der eigenen OpenProject-Instanz an.
(Bild: Screenshot / Thomas Joos)

Jira, MS Project und CSV liefern die Altdaten

Der „Jira Migrator“ liest Projekte aus „Jira Server“ und „Data Center 10.x“ und „11.x“, „Jira Cloud“ noch nicht. OpenProject rät zu einem Pilotprojekt und danach zum Umzug in Wellen. Vorgänge aus MS Project übernimmt die kostenlose Excel-Synchronisierung. Einen CSV-Import für Arbeitspakete gibt es im Oktober 2026 nur im Entwicklungszweig. Hierarchien und Beziehungen zwischen Arbeitspaketen übernimmt er noch nicht.

Nach dem Import hält OpenProject Projekt, Arbeitspaket und Benutzer im Prüfmodus, bis der Administrator die Übernahme mit “Approve import” bestätigt oder mit “Revert import” vollständig zurücknimmt.(Bild:  Screenshot / Thomas Joos)
Nach dem Import hält OpenProject Projekt, Arbeitspaket und Benutzer im Prüfmodus, bis der Administrator die Übernahme mit “Approve import” bestätigt oder mit “Revert import” vollständig zurücknimmt.
(Bild: Screenshot / Thomas Joos)

Das Backup sichert vier Bestandteile

Zu sichern sind Datenbank, Konfigurationsdateien, Anhänge und gegebenenfalls Git- oder Subversion-Repositories. Bei der Paketinstallation schreibt ein Befehl je Bestandteil ein Archiv nach /var/db/openproject/backup, zum Beispiel attachments-<Zeitstempel>.tar.gz und postgresql-dump-<Zeitstempel>.pgdump. Von dort lohnt sich der Transfer auf einen Sicherungsserver oder in einen S3-Bucket.

sudo openproject run backup

Im Compose-Stack sichert eine eigene Steuerungsebene PostgreSQL-Daten und Anhänge bei gestopptem Stack.

docker compose down

docker compose -f docker-compose.yml -f docker-compose.control.yml build

docker compose -f docker-compose.yml -f docker-compose.control.yml run backup

docker compose up -d

Der Restore beginnt mit gestoppten Diensten

Bei der Paketinstallation hält

sudo service openproject stop

zuerst die Instanz an. Danach entpackt tar die Anhänge nach /var/db/openproject/files und die Konfiguration nach /etc/openproject. Die Datenbank spielt pg_restore zurück und löscht dabei die vorhandenen Objekte der Zieldatenbank.

sudo pg_restore --clean --if-exists --dbname $(sudo openproject config:get DATABASE_URL) postgresql-dump-<Zeitstempel>.pgdump

Im Compose-Stack stoppt

docker compose stop web worker cron seeder

die Schreibzugriffe. Danach legt der Administrator die Datenbank mit psql neu an, importiert den Dump und führt mit

docker compose run --rm seeder

die restlichen Migrationen aus.

Updates folgen dem Takt der Hauptversionen

Da OpenProject nur den Wechsel von einer Hauptversion zur jeweils nächsten unterstützt, führt der Weg von X auf X+2 immer über X+1. Vor jedem Update steht eine Sicherung. Patch- und Nebenversionen spielt die Paketinstallation unter Debian und Ubuntu mit drei Befehlen ein. Der letzte Befehl openproject configure führt dabei die Datenbankmigrationen aus.

sudo apt-get update

sudo apt-get install --only-upgrade openproject

sudo openproject configure

Für eine neue Hauptversion tauscht der Administrator die Paketquelle in /etc/apt/sources.list.d/openproject.list aus. Im Compose-Stack holt "git pull origin stable/17" den aktuellen Stand. Für den Sprung auf die nächste Hauptversion wechselt "git checkout" vorher auf deren Zweig. Danach sichert der Administrator mit "run backup", aktualisiert mit "run upgrade" und lädt mit

docker compose up -d --build --pull always

die neuen Images. Ältere Stacks auf PostgreSQL 13 wechseln per Dump und Restore auf PostgreSQL 17.

Sicherheitshinweise gehören in den Wartungsplan

Am 08.06 2026 veröffentlichte OpenProject ein Advisory zu einer SQL-Injection über den Parameter timestamps mit einem CVSS-Wert von 9,9. Für einen Angriff genügt ein Konto mit geringen Rechten. Die Lücke betrifft alle Versionen vor 17.3.3 und ist in 17.3.3 sowie 17.4.1 behoben. Am 08.07.2026 folgten vier weitere Advisories, drei davon zu Zugriffsrechten in der API. Per Mail meldet GitHub neue Advisories, sobald ein Konto das Repository mit "Security alerts" beobachtet.

Das Betriebsteam regelt Zuständigkeiten vor dem Start

Vor dem Produktivstart sollte das Betriebsteam fünf Punkte festlegen:

  • 1. Die .env-Datei oder values.yaml steht mit Geheimnis, Hostname und PostgreSQL-Version in der Versionsverwaltung.
  • 2. Ein Reverse Proxy terminiert TLS und leitet WebSockets für den Kollaborationsserver weiter.
  • 3. Das Monitoring fragt die Health-Check-Endpunkte für Web, Datenbank und Worker ab.
  • 4. Sicherungen wechseln täglich vom Server auf ein getrenntes Ziel. Ein Restore ist mindestens einmal geprobt.
  • 5. Eine benannte Person liest Release Notes und Advisories und plant Patchversionen in einem festen Rhythmus ein.

(ID:51014362)