description: 'Korte handleiding voor het updaten van een Docker-gebaseerde OTOBO-installatie naar een nieuwe hoofd- of subversie'

OTOBO Docker Update – Veilige upgrade van versies

Regelmatig uw OTOBO-installatie upgraden zorgt ervoor dat u direct profiteert van nieuwe functies, beveiligingspatches en bugfixes. Deze handleiding legt uit hoe u in een paar stappen een Docker-gebaseerde OTOBO-instantie naar de gewenste release brengt.

Vereisten

• Een bestaande OTOBO-installatie met Docker & Docker Compose
• SSH-toegang tot de host
• Back-up van uw belangrijke gegevens (Docker-volumes voor /opt/otobo, database, Elasticsearch-index)
• Gewenste doelversie, bijv. 11.0.10 of 10.1.8

Stap 1: Docker Compose-configuratie bijwerken

1. Navigeer naar de map van uw OTOBO Docker-project:

   cd /opt/otobo-docker

2. Haal nieuwe Git-tags op en schakel over naar de gewenste release:

   git fetch --tags
   git checkout rel-11_0_10    # Voorbeeld voor versie 11.0.10

3. Pas indien nodig uw .env aan, bijv.:

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

Stap 2: Nieuwe Docker-images ophalen

docker-compose pull

Stap 3: Containers stoppen en bijwerken

1. Oude containers stoppen (volumes blijven behouden):

   docker-compose down

2. Code-volume migreren naar de nieuwe versie:

   docker-compose run --rm web copy_otobo_next

3. Containers starten met nieuwe software:

   docker-compose up -d

Stap 4: OTOBO-interne update uitvoeren

1. Update-taken uitvoeren:

   docker-compose exec web entrypoint.sh do_update_tasks

2. Optioneel: Database migratiescript voor hoofdversies (bijv. 10.1→11.0):

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

3. Update-logboek controleren:

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

Stap 5: Afronding & Controle

• Status controleren: docker-compose ps toont of alle containers draaien
• Login testen: Zorg ervoor dat agenten en klanten kunnen inloggen
• Snelle test: Maak een ticket aan, verstuur e-mails en controleer kernfuncties

Beschikbare OTOBO-versies

Hoofd- en subversies (selectie):

• 11.0.10: Biedt interne verbeteringen en bijgewerkte Docker-tags voor stabiele implementaties.
• 11.0.9: Dicht een kritieke beveiligingskwetsbaarheid (CVE-2025-43926) en optimaliseert de ticketzoekmodule.
• 11.0.8: Versterkte wachtwoord-hashing-algoritmen en verbeterde two-factor authenticatie.
• 11.0.7: Diverse bugfixes, waaronder correcties voor checkbox-weergave en artikelkoppelingen.
• 11.0.6: Belangrijke beveiligingsupdates tegen JavaScript-injectie en overstap naar CKEditor 5.
• 11.0.5: Layout-optimalisaties voor CKEditor 5 en verbeterde vertaling van services.
• 11.0.4: Uitgebreid vertaalsysteem en geoptimaliseerde Docker quickstart-scripts.
• 11.0.3: Verhelpt databasefouten bij ticket-samenvoeging en problemen met dynamische velden.
• 11.0.2: Automatisch laden van ITSM-repositories en betere upgrade-detectie voor core-pakketten.
• 11.0.1: Nieuwe dynamische veldfuncties en een high-contrast skin voor betere toegankelijkheid.
• 11.0.0-beta3: Overstap naar HTML::Scrubber voor veiliger Safety()-gedrag.
• 11.0.0-beta2: Verfijnde dynamische referentievelden en integratie van nieuwe core-pakketten.
• 10.1.8: Beveiligingsfix voor XSS in AdminCustomerUser en robuuste HTTP-header validatie.
• 10.1.7: Verbeterde kalenderweergave en stabielere Elasticsearch-afhandeling.
• 10.1.6: Dicht een SQL-injectie in TicketSearch en optimaliseert afspraakmeldingen.
• 10.1.5: Voorkomt code-injectie in ACL's en werkt belangrijke JavaScript-bibliotheken bij.
• 10.1.4: Corrigeert hiaten in LDAP-synchronisatie en verbetert bulk-updates.
• 10.1.3: Voorkomt server-side calls in de admin-interface en dicht XSS-kwetsbaarheden.
• 10.1.2: Bugfixes in de DynamicFieldDatabase-module voor consistente zoekresultaten.
• 10.1.1: Uitgebreid klantendashboard en verbeterde Elasticsearch self-healing.

Opmerking: Voor hoofdversie-sprongen (bijv. 10.1 → 11.0) altijd eerst een minor-upgrade (10.1) uitvoeren, daarna de major-upgrade (11.0).