Twenty CRM – Kurzer Upgrade Guide (Self-Hosting)

Schritte

1. Vorbereitung

   • Aktuelle Version & laufende Container prüfen: docker compose ps
   • Release Notes / Changelog lesen (Breaking Changes, Migrations).
   • Releases finden sich auf https://hub.docker.com/r/twentycrm/twenty

2. Backup

   • Datenbank sichern: ./database_backup.sh (legt Tages-Backup an).

3. Version aktualisieren (Docker Compose)

   • Anwendung stoppen: docker compose down
   • In der .env neben docker-compose.yml den Wert bei TAG= auf gewünschte Version setzen. Immer nur von einer Version auf die nächste, bitte keine Versionen überspringen!
   • Anwendung wieder starten: docker compose up -d

4. Validierung

   • Logs prüfen: docker compose logs --tail=100
   • Health-/API-Endpunkt testen (Login, Suche).
   • Oberfläche kurz manuell testen.

5. Rollback (falls Probleme)

   • Container stoppen: docker compose down
   • Vorherige Tags erneut setzen (in .env alten TAG eintragen).
   • Neu starten: docker compose up -d
   • Backup zurückspielen (falls nötig) mit database_backup.sh:

Hinweise

• Kein Upgrade ohne frisches Backup.
• Release Notes strikt befolgen (Schema-/Env-Änderungen).