Gestion du serveur local
Utilisezyarn twenty docker:* pour contrôler le conteneur Twenty local :
Les données sont conservées entre les redémarrages dans deux volumes Docker (
twenty-app-dev-data pour PostgreSQL, twenty-app-dev-storage pour les fichiers). Utilisez reset pour tout effacer.
Figer la version du serveur
Lorsqu’aucune version n’est fournie,docker:start résout la version à partir de la plage engines.twenty de votre package.json — la même plage que le serveur utilise pour la validation lors de l’installation de votre application. Il démarre l’image twenty-app-dev la plus récente publiée qui satisfait la plage, et revient à latest lorsque le champ est absent ou qu’aucune version publiée ne correspond :
yarn twenty docker:start 2.3.0. Si un conteneur existe déjà avec une version différente, docker:start le met à niveau sur place (en recréant le conteneur tout en préservant vos volumes de données).
Mise à niveau de l’image du serveur
yarn twenty docker:upgrade récupère la dernière image, compare les empreintes et ne recrée le conteneur que si quelque chose a réellement changé. Les volumes sont conservés — seul le conteneur est remplacé. Si une nouvelle image a été récupérée et que le conteneur était en cours d’exécution, la mise à niveau démarre automatiquement un nouveau conteneur ; exécutez ensuite yarn twenty docker:start pour attendre qu’il devienne opérationnel.
yarn twenty docker:status (elle affiche la valeur de APP_VERSION intégrée au conteneur).
Exécuter une instance de test parallèle
Passez--test à n’importe quelle commande docker:* pour gérer une deuxième instance totalement isolée — utile pour les tests d’intégration ou pour expérimenter sans toucher à vos données de développement principales :
L’instance de test possède son propre conteneur (
twenty-app-dev-test), ses volumes (twenty-app-dev-test-data, twenty-app-dev-test-storage) et sa configuration — elle s’exécute parallèlement à votre instance principale sans conflits. Combinez --test avec --port pour remplacer le port 2021.
Configuration manuelle (sans le générateur)
Ignorez le générateur si vous ajoutez le SDK à un projet existant :package.json :
yarn twenty dev, yarn twenty docker:start et le reste.
N’installez pas
twenty-sdk globalement — figez-le par projet afin que chaque application utilise sa propre version.