OTOBO Docker–Update – Version sicher upgraden

Ein regelmäßiges Upgrade Ihrer OTOBO‑Installation stellt sicher, dass Sie neue Features, Sicherheits‑Patch­es und Bugfixes sofort nutzen können. Diese Anleitung erklärt, wie Sie in wenigen Schritten eine Docker‑basierte OTOBO‑Instanz auf das gewünschte Release bringen.

Voraussetzungen

• Eine bestehende OTOBO‑Installation mit Docker & Docker Compose
• SSH‑Zugriff auf den Host
• Backup Ihrer wichtigen Daten (Docker‑Volumes für /opt/otobo, Datenbank, Elasticsearch‑Index)
• Gewünschte Zielversion, z. B. 11.0.10 oder 10.1.8

Schritt 1: Docker‑Compose‑Konfiguration aktualisieren

1. In das Verzeichnis Ihres OTOBO‑Docker‑Projekts wechseln:

   cd /opt/otobo-docker

2. Neue Git‑Tags abrufen und auf das gewünschte Release wechseln:

   git fetch --tags
   git checkout rel-11_0_10    # Beispiel für Version 11.0.10

3. Falls nötig, Ihre .env anpassen, z. B.:

   OTOBO_IMAGE=rotheross/otobo:11.0.10
   OTOBO_IMAGE_ELASTICSEARCH=elasticsearch:8.8.2
   OTOBO_IMAGE_NGINX=nginx:1.23-alpine

Schritt 2: Neue Docker‑Images holen

docker-compose pull

Schritt 3: Containers stoppen und aktualisieren

1. Alte Container stoppen (Volumes bleiben erhalten):

   docker-compose down

2. Code‑Volume auf die neue Version migrieren:

   docker-compose run --rm web copy_otobo_next

3. Container mit neuer Software starten:

   docker-compose up -d

Schritt 4: OTOBO‑internes Update durchführen

1. Update‑Tasks ausführen:

   docker-compose exec web entrypoint.sh do_update_tasks

2. Optional: Datenbank‑Migrationsskript für Haupt‑Releases (z. B. 10.1→11.0):

   docker exec -it otobo_web_1 perl scripts/DBUpdate-to-11.0.pl

3. Update‑Log prüfen:

   docker-compose exec web cat /opt/otobo/var/log/update.log

Schritt 5: Abschluss & Kontrolle

• Status prüfen: docker-compose ps zeigt an, ob alle Container laufen
• Login testen: Stellen Sie sicher, dass Agenten und Kunden sich anmelden können
• Kurztest: Erstellen Sie ein Ticket, versenden Sie E‑Mails und prüfen Sie Kern­funktionen

Verfügbare OTOBO‑Versionen

Haupt‑ und Neben‑Releases (Auswahl):

• 11.0.16 (Apr. 2026): Security‑Patch – behebt XSS (CVE-2025-59490) und aktualisiert Compress::Raw::Zlib gegen CVE-2026-3381 in Docker; E‑Mail‑X‑Header als Quelle für dynamische Felder nutzbar.
• 11.0.15 (Feb. 2026): Fixes für Multi‑Value‑Felder bei leeren Werten und CKEditor‑Formatierung; Korrektur eines Datenbank‑Attributs.
• 11.0.14 (Dez. 2025): Stabilitäts‑ und Fehlerbehebungen.
• 11.0.13 (Okt. 2025): Wartungsrelease mit Fehlerbehebungen.
• 11.0.12 (Sep. 2025): Wartungsrelease mit Fehlerbehebungen.
• 11.0.11: OTOBO übernimmt die Log‑Rotation für otobo.log nun direkt, was externe Konfigurationen vereinfacht.
• 11.0.10: Bietet interne Verbesserungen und aktualisierte Docker‑Tags für stabile Deployments.
• 11.0.9: Schließt eine kritische Sicherheitslücke (CVE-2025-43926) und optimiert das Ticket‑Suchmodul.
• 11.0.8: Verstärkte Passwort-Hashing-Algorithmen und verbesserte Zwei‑Faktor‑Authentifizierung.
• 11.0.7: Diverse Bugfixes, u. a. Korrekturen bei Checkbox‑Darstellung und Artikel‑Links.
• 11.0.6: Wichtige Sicherheitsupdates gegen JavaScript‑Injektion und Umstellung auf CKEditor 5.
• 11.0.5: Layout‑Optimierungen für CKEditor 5 und verbesserte Übersetzung von Services.
• 11.0.4: Erweitertes Übersetzungssystem und optimierte Docker‑Quickstart‑Skripte.
• 11.0.3: Behebt Datenbankfehler beim Ticket‑Merge und Probleme mit dynamischen Feldern.
• 11.0.2: Automatisches Laden von ITSM‑Repos und bessere Upgrade‑Erkennung für Core‑Pakete.
• 11.0.1: Neue dynamische Feld‑Funktionen und ein High‑Contrast‑Skin für bessere Barrierefreiheit.
• 11.0.0‑beta3: Umstellung auf HTML::Scrubber für sichereres Safety()‑Verhalten.
• 11.0.0‑beta2: Verfeinerte dynamische Referenzfelder und Integration neuer Core‑Pakete.
• 10.1.8: Sicherheitsfix für XSS in AdminCustomerUser und robuste HTTP‑Header‑Validierung.
• 10.1.7: Verbesserte Kalenderdarstellung und stabileres Elasticsearch‑Handling.
• 10.1.6: Schließt eine SQL‑Injection in TicketSearch und optimiert Terminbenachrichtigungen.
• 10.1.5: Verhindert Code‑Injection in ACLs und aktualisiert wichtige JavaScript‑Bibliotheken.
• 10.1.4: Korrigiert Lücken bei LDAP‑Synchronisation und verbessert Massenaktualisierungen.
• 10.1.3: Verhindert Server‑Side‑Calls im Admin-Interface und schließt XSS‑Lücken.
• 10.1.2: Fehlerbehebungen im DynamicFieldDatabase-Modul für beständige Suche.
• 10.1.1: Erweiterter Kunden‑Dashboard und verbesserte Elasticsearch‑Selbstheilung.

Hinweis: Für Haupt‑Versionssprünge (z. B. 10.1 → 11.0) immer erst Minor‑Upgrade (10.1) durchführen, dann Major‑Upgrade (11.0).

Häufig gestellte Fragen

Warum ist ein regelmäßiges OTOBO-Update wichtig?

Regelmäßige Updates Ihrer OTOBO-Installation sind entscheidend, um die Sicherheit, Stabilität und Funktionalität Ihres Systems zu gewährleisten. Jedes neue Release bringt in der Regel wichtige Sicherheits-Patches mit sich, die bekannte Schwachstellen beheben und Ihr System vor potenziellen Angriffen schützen. Darüber hinaus erhalten Sie Zugang zu neuen Features und Verbesserungen, die die Benutzerfreundlichkeit und Effizienz steigern können. Auch Bugfixes für bestehende Probleme sind ein zentraler Bestandteil von Updates, wodurch die Gesamtstabilität und Zuverlässigkeit von OTOBO verbessert wird. Ein aktuelles System minimiert Ausfallzeiten und sorgt für eine reibungslose Arbeitsweise.

Quellen

• OTOBO Docker–Update – Version sicher upgraden
• Updating a Docker-based Installation of OTOBO

Was sind die notwendigen Voraussetzungen für ein OTOBO Docker-Update?

Für ein erfolgreiches Update Ihrer Docker-basierten OTOBO-Installation müssen mehrere Voraussetzungen erfüllt sein. Zunächst benötigen Sie eine bestehende OTOBO-Installation mit Docker und Docker Compose, da diese Anleitung speziell auf diese Umgebung zugeschnitten ist. Des Weiteren ist ein SSH-Zugriff auf den Host erforderlich, um die notwendigen Befehle ausführen zu können. Ein absolutes Muss ist ein vollständiges Backup Ihrer wichtigen Daten, einschließlich der Docker-Volumes für /opt/otobo, der Datenbank und des Elasticsearch-Index. Dies stellt sicher, dass Sie bei unerwarteten Problemen jederzeit zu einem funktionierenden Zustand zurückkehren können. Schließlich müssen Sie die gewünschte Zielversion von OTOBO kennen, z. B. 11.0.10 oder 10.1.8, um die entsprechenden Images und Konfigurationen abrufen zu können.

Quellen

• OTOBO Docker–Update – Version sicher upgraden
• Updating a Docker-based Installation of OTOBO

Welche Schritte sind für das Aktualisieren einer Docker-basierten OTOBO-Installation erforderlich?

Das Aktualisieren einer Docker-basierten OTOBO-Installation umfasst mehrere aufeinanderfolgende Schritte, um einen reibungslosen Übergang zur neuen Version zu gewährleisten. Zuerst müssen Sie Ihre Docker-Compose-Konfiguration aktualisieren, indem Sie das Git-Repository auf das gewünschte Release wechseln und gegebenenfalls die .env-Datei anpassen. Anschließend ziehen Sie die neuen Docker-Images mit docker-compose pull. Danach stoppen Sie die laufenden Container, migrieren das Code-Volume mit copy_otobo_next und starten die Container mit der neuen Software. Im vierten Schritt führen Sie die OTOBO-internen Update-Tasks aus, einschließlich optionaler Datenbank-Migrationsskripte für Haupt-Releases. Abschließend ist eine gründliche Kontrolle der Systemfunktionen unerlässlich, um sicherzustellen, dass alles wie erwartet funktioniert.

Quellen

• OTOBO Docker–Update – Version sicher upgraden
• Updating a Docker-based Installation of OTOBO

Wie führe ich die Docker-Compose-Konfiguration und die Image-Aktualisierung durch?

Zuerst navigieren Sie in das Verzeichnis Ihres OTOBO-Docker-Projekts, typischerweise /opt/otobo-docker, mittels cd /opt/otobo-docker. Dort rufen Sie die neuesten Git-Tags ab und wechseln auf das gewünschte Release, zum Beispiel git fetch --tags gefolgt von git checkout rel-11_0_10 für Version 11.0.10. Es ist wichtig, dass Sie Ihre lokale .env-Datei überprüfen und anpassen, um die korrekten Image-Versionen für OTOBO, Elasticsearch und Nginx zu referenzieren, z.B. OTOBO_IMAGE=rotheross/otobo:11.0.10. Nachdem die Konfiguration aktualisiert ist, laden Sie die neuen Docker-Images herunter, indem Sie docker-compose pull ausführen. Dieser Befehl stellt sicher, dass alle benötigten Images für die neue OTOBO-Version auf Ihrem System verfügbar sind.

Quellen

• OTOBO Docker–Update – Version sicher upgraden
• Updating a Docker-based Installation of OTOBO
• RotherOSS/otobo-docker

Wie werden die OTOBO-Container während des Updates behandelt und die interne OTOBO-Aktualisierung durchgeführt?

Nach der Aktualisierung der Konfiguration und dem Herunterladen der neuen Images müssen Sie die alten Container sauber stoppen, ohne die Daten zu verlieren. Dies geschieht mit docker-compose down. Anschließend ist es entscheidend, das Code-Volume auf die neue Version zu migrieren, was mittels docker-compose run --rm web copy_otobo_next erfolgt. Dieser Schritt stellt sicher, dass die OTOBO-Anwendungsdateien aktualisiert werden. Danach starten Sie die Container mit der neuen Software im Hintergrund: docker-compose up -d. Sobald die Container laufen, führen Sie die OTOBO-internen Update-Tasks aus mit docker-compose exec web entrypoint.sh do_update_tasks. Bei Haupt-Versionssprüngen, wie von 10.1 auf 11.0, ist zusätzlich ein spezielles Datenbank-Migrationsskript auszuführen, z.B. docker exec -it otobo_web_1 perl scripts/DBUpdate-to-11.0.pl. Überprüfen Sie abschließend das Update-Log unter /opt/otobo/var/log/update.log.

Quellen

• OTOBO Docker–Update – Version sicher upgraden
• Updating a Docker-based Installation of OTOBO

Was muss ich nach einem OTOBO-Update überprüfen, um die Funktionalität sicherzustellen?

Nach Abschluss aller Update-Schritte ist eine sorgfältige Überprüfung der OTOBO-Installation unerlässlich, um sicherzustellen, dass alles korrekt funktioniert. Beginnen Sie damit, den Status aller Docker-Container zu prüfen, indem Sie docker-compose ps ausführen. Alle Container sollten als "running" angezeigt werden. Testen Sie anschließend die Anmeldefunktion für Agenten und Kunden, um sicherzustellen, dass sich alle Benutzer erfolgreich anmelden können. Führen Sie einen Kurztest der Kernfunktionen durch: Erstellen Sie ein neues Ticket, versuchen Sie, E-Mails zu versenden und zu empfangen, und prüfen Sie, ob wichtige Module wie die Ticket-Suche oder die dynamischen Felder wie erwartet funktionieren. Ein Blick in die OTOBO-Logs kann ebenfalls Aufschluss über mögliche Probleme geben.

Quellen

• OTOBO Docker–Update – Version sicher upgraden
• Updating a Docker-based Installation of OTOBO

Gibt es besondere Hinweise bei Haupt-Versionssprüngen von OTOBO?

Ja, bei Haupt-Versionssprüngen, wie beispielsweise von OTOBO 10.1 auf 11.0, gibt es einen wichtigen Hinweis zu beachten, um Kompatibilitätsprobleme zu vermeiden. Es wird dringend empfohlen, zuerst ein Minor-Upgrade innerhalb der aktuellen Hauptversion durchzuführen (z.B. von 10.1.x auf die neueste 10.1.y-Version), bevor Sie den eigentlichen Major-Upgrade auf die nächste Hauptversion (z.B. 11.0) vornehmen. Dies stellt sicher, dass alle notwendigen Zwischenschritte und Datenbankmigrationen korrekt angewendet werden. Für Haupt-Releases ist zudem oft ein spezielles Datenbank-Migrationsskript erforderlich, wie das im Guide erwähnte perl scripts/DBUpdate-to-11.0.pl, das manuell ausgeführt werden muss, um die Datenbankstrukturen an die neue Hauptversion anzupassen.

Quellen

• OTOBO Docker–Update – Version sicher upgraden
• Updating a Docker-based Installation of OTOBO