Skip to main content

​
Consignes générales

Sauvegardez toujours votre base de données avant de commencer le processus de mise à niveau en exécutant :
Pour restaurer à partir d’une sauvegarde :
Si vous utilisez Docker Compose, suivez ces étapes :
  1. Arrêtez Twenty : docker compose down
  2. Modifiez la valeur de TAG dans le fichier .env situé à côté de votre docker-compose.yml
  3. Démarrez Twenty : docker compose up -d
Le serveur exécute automatiquement au démarrage toutes les migrations de mise à niveau requises. Aucune commande manuelle n’est nécessaire.

​
Mises à niveau entre versions (v1.23+)

À partir de v1.23, Twenty prend en charge les mises à niveau entre versions. Vous pouvez passer directement de n’importe quelle version prise en charge à la dernière version sans devoir passer par chaque version intermédiaire. Par exemple, la mise à niveau de la v1.23 directement vers la v2.0 est entièrement prise en charge.

​
Mise à niveau vers la v2.5+ — enveloppe de chiffrement au repos

À partir de la v2.5, Twenty stocke les secrets au repos (jetons OAuth, variables d’application, clés privées de signature, valeurs de configuration sensibles, secrets TOTP) à l’intérieur d’une enveloppe versionnée enc:v2: chiffrée avec ENCRYPTION_KEY (ou APP_SECRET si ENCRYPTION_KEY n’est pas défini). Le premier démarrage sur la v2.5 exécute des commandes de mise à niveau lentes qui rétro-remplissent les lignes existantes dans la nouvelle enveloppe. Elles sont idempotentes — si vous interrompez puis redémarrez le serveur, le processus reprend là où il s’était arrêté — mais elles peuvent prendre du temps sur les grandes bases de données. Vous pouvez surveiller la progression avec upgrade:status. Vous devez définir une ENCRYPTION_KEY dédiée avant la mise à niveau vers la v2.5 afin que le rétro-remplissage écrive les lignes sous cette clé dès le départ. Changer de clé après le rétro-remplissage nécessite une rotation.

​
Rotation des secrets et des clés de signature

Pour les tâches opérationnelles quotidiennes comme la rotation de ENCRYPTION_KEY, la rotation de la clé de signature JWT ou la révocation d’une clé de signature divulguée, consultez le Guide de rotation des clés dédié.

​
Vérification de l’état de la mise à niveau

La commande upgrade:status vous permet d’inspecter l’état actuel de votre instance et des migrations d’espaces de travail. Elle est utile pour diagnostiquer les problèmes de mise à niveau ou lors de la création d’une demande d’assistance. Exécutez-la depuis le conteneur du serveur :
Exemple de résultat:

​
Options

​
Résolution des problèmes

Si la mise à niveau échoue sur certains espaces de travail, le serveur ne dépassera pas l’étape en échec. Le redémarrage du serveur (docker compose up -d) relancera la mise à niveau à partir de l’endroit où elle s’est arrêtée. Pour identifier rapidement les problèmes, exécutez :
Cela affiche uniquement les espaces de travail en retard ou en échec, ainsi que le message d’erreur pour chaque échec.

​
Avant la v1.23

Si votre instance est antérieure à la v1.23, vous devez effectuer une mise à niveau progressive à travers chaque version majeure marquée (de v1.6 à v1.7, puis de v1.7 à v1.8, et ainsi de suite) jusqu’à atteindre la v1.23. À partir de là, vous pouvez passer directement à la dernière version.