snapshot of https://github.com/twentyhq/twenty.git (main, 2026-09-17; blobs > 131072B omitted)

packages/twenty-docs/l/fr/developers/extend/apps/getting-started/local-server.mdx

@@ -0,0 +1,87 @@
+---
+title: Serveur local
+description: Gérez le serveur Docker local de Twenty — démarrage, arrêt, mise à niveau, instance de test parallèle et configuration manuelle du SDK.
+icon: server
+---
+
+## Gestion du serveur local
+
+Utilisez `yarn twenty docker:*` pour contrôler le conteneur Twenty local :
+
+| Commande                               | Ce que cela fait                                           |
+| -------------------------------------- | ---------------------------------------------------------- |
+| `yarn twenty docker:start`             | Démarre le serveur (récupère l’image si nécessaire)        |
+| `yarn twenty docker:start 2.2.0`       | Démarrer une version spécifique du serveur                 |
+| `yarn twenty docker:start --port 3030` | Démarre sur un port personnalisé                           |
+| `yarn twenty docker:stop`              | Arrête le serveur (préserve les données)                   |
+| `yarn twenty docker:status`            | Affiche l’URL, la version et les identifiants de connexion |
+| `yarn twenty docker:logs`              | Diffuse les journaux du serveur                            |
+| `yarn twenty docker:reset`             | Efface les données et repart de zéro                       |
+| `yarn twenty docker:upgrade`           | Récupère la dernière image `twenty-app-dev`                |
+| `yarn twenty docker:upgrade 2.2.0`     | Met à niveau vers une version spécifique                   |
+
+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 :
+
+```json filename="package.json"
+{
+  "engines": {
+    "twenty": ">=2.2.0"
+  }
+}
+```
+
+Passez explicitement une version pour remplacer la plage pour une seule exécution : `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.
+
+```bash filename="Terminal"
+yarn twenty docker:upgrade            # Latest
+yarn twenty docker:upgrade 2.2.0      # Specific version
+```
+
+Vérifiez la version en cours d’exécution avec `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 :
+
+| Commande                            | Ce que cela fait                                  |
+| ----------------------------------- | ------------------------------------------------- |
+| `yarn twenty docker:start --test`   | Démarre l’instance de test (port 2021 par défaut) |
+| `yarn twenty docker:stop --test`    | L’arrête                                          |
+| `yarn twenty docker:status --test`  | Affiche son statut                                |
+| `yarn twenty docker:logs --test`    | Diffuse ses journaux                              |
+| `yarn twenty docker:reset --test`   | Efface ses données                                |
+| `yarn twenty docker:upgrade --test` | Met à niveau son image                            |
+
+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 :
+
+```bash filename="Terminal"
+yarn add twenty-sdk twenty-client-sdk
+```
+
+Ajoutez le script à `package.json` :
+
+```json filename="package.json"
+{
+  "scripts": {
+    "twenty": "twenty"
+  }
+}
+```
+
+Vous pouvez maintenant exécuter `yarn twenty dev`, `yarn twenty docker:start` et le reste.
+
+<Note>
+N’installez pas `twenty-sdk` globalement — figez-le par projet afin que chaque application utilise sa propre version.
+</Note>