Pourquoi les équipes de développement auto-hébergent Twenty plutôt que de payer Salesforce
La plupart des CRM sont conçus pour les responsables commerciaux, pas pour les ingénieurs. Le schéma est figé, l'API est soumise à des limites de débit et chaque intégration passe par une marketplace propriétaire. Twenty inverse la logique : chaque entité (contacts, entreprises, opportunités ou tout objet personnalisé que vous définissez) est modélisée dans PostgreSQL et exposée via une API GraphQL entièrement documentée dès le premier jour. Vous êtes propriétaire de la base de données, vous écrivez les migrations et vous vous intégrez à votre propre outillage — sans middleware ni facturation à l'appel d'API.
Ce que vous obtenez d'emblée
- Objets et champs entièrement personnalisables — modélisez n'importe quelle entité utile à votre activité, pas seulement celles imposées par Salesforce.
- Vues Kanban, liste et tableau, avec mises à jour collaboratives en temps réel pour toute l'équipe.
- Notes, tâches et fil d'activité rattachés à chaque enregistrement — sans plugin supplémentaire.
- API GraphQL + REST couvrant chaque objet, relation et champ personnalisé que vous créez.
- Worker d'arrière-plan pour les automatisations, webhooks et tâches planifiées — il s'exécute aux côtés du conteneur serveur.
- Import CSV pour migrer contacts et entreprises depuis HubSpot, Pipedrive ou n'importe quel ancien CRM.
- Licence AGPL-3.0 — pas de dépendance à un éditeur, pas de facturation cloud par utilisateur, aucune donnée stockée hors de votre infrastructure.
Prérequis
Un VPS de 2 vCPU / 4 Go de RAM sous Ubuntu 22.04 avec Docker installé couvre confortablement la production. La stack complète (serveur + worker + PostgreSQL + Redis) consomme environ 1,2 Go de RAM au repos ; prévoyez 4 Go pour laisser à PostgreSQL de la marge sous des requêtes concurrentes. Un nom de domaine et un reverse proxy Caddy ou Nginx pour le HTTPS. C'est tout — pas de GPU, pas de clé de licence, aucun service externe.
Déployer Twenty sur un VPS en 6 étapes
Provisionner le VPS
Commandez un VPS ServOrbit (4 Go de RAM, 2 vCPU, Ubuntu 22.04). Une fois démarré, connectez-vous en SSH et installez Docker : curl -fsSL https://get.docker.com | sh. Activez le service Docker : systemctl enable --now docker.
Créer votre fichier .env
Créez /opt/twenty/.env avec quatre variables : APP_SECRET (générée avec openssl rand -hex 32), DB_NAME=twenty, DB_USER=twenty, DB_PASSWORD=<strong-password> et SERVER_URL=https://crm.votre-domaine.com (renseignez-la dès maintenant — Twenty l'intègre dans les en-têtes CORS et les liens des e-mails). APP_SECRET est le seul secret cryptographique ; tout le reste en découle.
Rédiger docker-compose.yml et démarrer la stack
Créez /opt/twenty/docker-compose.yml avec les quatre services : db (postgres:16-alpine), redis (redis:7-alpine), twenty-server (twentycrm/twenty:latest, port 3000) et twenty-worker (même image, commande yarn worker:prod). Reliez-les via PG_DATABASE_URL et REDIS_URL. Ensuite : docker compose up -d. Au premier démarrage, Twenty exécute les migrations de base de données — comptez 60 à 90 secondes avant que l'interface soit prête.
Finaliser la configuration de l'espace de travail
Ouvrez http://<vps-ip>:3000 et suivez l'assistant de configuration : créez votre compte administrateur, nommez l'espace de travail et, si vous le souhaitez, invitez vos collègues par e-mail. Importez vos contacts existants depuis un fichier CSV dans les paramètres de l'espace de travail → Import.
Placer Twenty derrière HTTPS avec Caddy
Installez Caddy : apt install -y caddy. Créez /etc/caddy/Caddyfile : crm.votre-domaine.com { reverse_proxy localhost:3000 }. Rechargez : systemctl reload caddy. Caddy obtient et renouvelle le certificat TLS automatiquement. Restreignez le port 3000 dans votre pare-feu : ufw deny 3000 — tout le trafic passe désormais par le 443.
Connecter vos outils d'automatisation
Dans les paramètres de Twenty → API, copiez votre endpoint GraphQL et votre jeton d'API personnel. Utilisez-les directement dans n8n (nœud HTTP Request) ou Activepieces pour synchroniser des contacts, déclencher des actions au changement d'étape d'une opportunité ou envoyer des données depuis des sources externes. Twenty émet aussi des webhooks sortants à chaque événement sur un enregistrement — configurez-les dans les paramètres → Webhooks.
Se connecter la première fois
Ouvrez l'URL et cliquez sur « Sign up » : le premier inscrit devient automatiquement administrateur de l'espace de travail, et les inscriptions se ferment ensuite. Faites-le immédiatement après l'installation.
Sauvegardez chaque jour les trois volumes Docker — twenty_db (données PostgreSQL), twenty_data (stockage de fichiers local) et twenty_redis (utile uniquement si vous utilisez des files de tâches persistantes) — vers un emplacement hors serveur. Une simple commande sur une ligne, docker run --rm -v twenty_db:/data -v /backups:/out alpine tar czf /out/twenty-db-$(date +%F).tar.gz /data, placée dans une tâche cron suffit à sauvegarder la base de données.
La documentation officielle
Pour la configuration avancée et les options propres à l'outil, référez-vous à la documentation officielle de Twenty. Ce guide couvre la mise en ligne sur VPS ; la doc éditeur reste la référence pour les réglages fins, les mises à jour majeures et les cas d'usage spécifiques.
