Auto-héberger un CRM IA : Docker, Ollama, MCP - Relaticle         

Auto-héberger un CRM natif IA en 2026
=====================================

Auto-hébergez Relaticle avec Docker, Coolify ou Dokploy. Découvrez la configuration des modèles et du broadcasting qu'exige le chat, et les limites de MCP et des crédits.

 Manuk Minasyan · 18 août 2026 · 14 min de lecture

 ![Auto-héberger un CRM natif IA en 2026](https://relaticle.com/storage/ink/01M7T42KHQ5JH2QYA5CT7XGJAY.png) 

Relaticle peut être auto-hébergé, mais le fichier Compose standard ne configure pas à lui seul un déploiement fonctionnel de Rela, l'assistant IA intégré. Il faut une configuration supplémentaire pour les modèles et le broadcasting. Ce guide couvre les déploiements avec Docker Compose, Coolify et Dokploy. Il indique aussi le travail supplémentaire qu'exige l'IA locale et explique les limites qui subsistent quand vous exploitez vous-même l'application.

[](#pourquoi-auto-héberger-aussi-les-fonctions-dia "Permalink")Pourquoi auto-héberger aussi les fonctions d'IA
--------------------------------------------------------------------------------------------------------------

Beaucoup de CRM qui annoncent un assistant IA ou une intégration MCP font tourner ces fonctions précises depuis leur propre cloud, même lorsque le reste du produit a son code source disponible. La pile IA de Relaticle est du code applicatif ordinaire et non un module complémentaire hébergé. L'assistant de chat est un package Laravel. Le MCP server est une route déclarée dans `routes/ai.php` comme n'importe quelle autre. Aucun des deux ne dépend d'une vérification d'abonnement tant que l'indicateur de fonctionnalité de facturation est désactivé, ce qui est le cas par défaut dans l'image Docker publiée. Vous pouvez brancher l'assistant sur Anthropic ou OpenAI avec votre propre clé d'API. Vous pouvez aussi vous passer entièrement des fournisseurs cloud et exécuter un modèle local avec Ollama. Les deux voies utilisent la même interface de chat et les mêmes mécanismes d'accès au CRM. Par ailleurs, le MCP server expose l'ensemble de ses outils à tout client MCP : recherche et récupération, ainsi que création, lecture, mise à jour et suppression pour les entreprises, les personnes, les opportunités, les tâches et les notes. Auto-hébergé, il fonctionne exactement comme sur l'offre cloud de Relaticle. [Y connecter Claude](https://relaticle.com/fr/blog/connecter-claude-a-votre-crm-avec-mcp) prend environ deux minutes. Relaticle est distribué sous licence AGPL-3.0.

[](#prérequis "Permalink")Prérequis
-----------------------------------

Les trois voies de déploiement ci-dessous récupèrent la même image Docker officielle et le même `compose.yml`. Elles diffèrent surtout par la quantité d'infrastructure dont vous disposez déjà.

| Option de déploiement | Ce qu'il vous faut |
|---|---|
| Docker Compose (votre propre serveur) | 2 Go de RAM au minimum (4 Go recommandés), Docker 20.10+, Docker Compose v2+ |
| Coolify | Une instance Coolify en service et un domaine qui pointe vers elle |
| Dokploy | Une instance Dokploy en service et un domaine qui pointe vers elle |
| Manuel, sans conteneurs | PHP 8.5+, PostgreSQL 17+, Redis 7+, Node 22.12+ et pnpm, Composer 2+, Nginx ou Apache, Supervisor |

| Option de déploiement | Durée approx. |
|---|---|
| Docker Compose (votre propre serveur) | ~15 minutes |
| Coolify | ~15 minutes |
| Dokploy | ~15 minutes |
| Manuel, sans conteneurs | ~45-60 minutes |

![docker compose ps affiche app, horizon, scheduler, postgres et redis, tous en bonne santé](https://relaticle.com/storage/ink/01M09E1REFDVZZ0X83AX2KN5MA.png)

[](#déployer-avec-docker-compose "Permalink")Déployer avec Docker Compose
-------------------------------------------------------------------------

C'est la voie par laquelle commence le guide de Relaticle, et c'est la plus rapide si vous avez déjà un serveur avec Docker.

Téléchargez le fichier Compose :

```
curl -o compose.yml https://raw.githubusercontent.com/Relaticle/relaticle/main/compose.yml

```

Générez une clé d'application :

```
echo "APP_KEY=base64:$(openssl rand -base64 32)"

```

Créez un fichier `.env` à côté de `compose.yml` avec au moins les variables obligatoires :

```
APP_KEY=base64:your-generated-key-here
DB_PASSWORD=your-secure-database-password
APP_URL=https://crm.example.com
APP_PORT=8080

```

Démarrez les services principaux :

```
docker compose up -d

```

Cela lance cinq conteneurs : l'application (nginx + PHP-FPM), un worker Horizon pour les tâches en file d'attente, un conteneur scheduler qui exécute `schedule:work`, PostgreSQL 17 et Redis 7. Les migrations de la base de données s'exécutent automatiquement au premier démarrage, il n'y a donc pas d'étape de migration séparée.

Créez votre premier utilisateur administrateur :

```
docker compose exec app php artisan make:filament-user

```

Choisissez le panneau `app` lorsque la question vous est posée. Une fois votre reverse proxy configuré, ouvrez le CRM à l'adresse `{APP_URL}/app`. Si vous voulez aussi le panneau `sysadmin` valable pour toute l'instance (utile plus tard, voir la section sur les limites plus bas), exécutez plutôt `docker compose exec app php artisan sysadmin:create` ou choisissez `sysadmin` à la même question.

Placez un reverse proxy devant pour le TLS. L'exemple ci-dessus publie l'application sur le port 8080 de l'hôte et laisse les ports 80 et 443 à votre proxy. Dirigez le trafic HTTPS vers ce port et définissez `APP_URL` avec votre adresse HTTPS publique. Restreignez l'accès direct au port de l'application. L'application fait confiance aux en-têtes transmis par les réseaux privés et de bouclage configurés, donc gardez le proxy et la frontière réseau sous votre contrôle.

*Testé le 24 septembre 2026 avec l'image officielle de Relaticle 3.5.11. Un déploiement Docker Compose neuf a passé les cinq contrôles de santé des services, la création de l'administrateur et la connexion dans le navigateur.*

*Ce test n'a exécuté ni Coolify, ni Dokploy, ni une installation manuelle, ni l'émission de certificats TLS, ni d'inférence IA. Ces voies demandent leurs propres vérifications de déploiement.*

[](#déployer-avec-coolify "Permalink")Déployer avec Coolify
-----------------------------------------------------------

Si vous utilisez déjà [Coolify](https://coolify.io/) pour d'autres projets, ajouter Relaticle prend environ cinq minutes, comme n'importe quelle autre ressource Docker Compose :

1. Créez un nouveau projet dans le tableau de bord de Coolify.
2. Ajoutez une ressource, choisissez **Docker Compose**, sélectionnez **Empty** comme source et collez le contenu de `compose.yml`.
3. Définissez les variables d'environnement obligatoires (`APP_KEY`, `DB_PASSWORD`, `APP_URL`) dans l'onglet Environment Variables de la ressource.
4. Définissez votre domaine dans l'onglet Settings du service app. Coolify émet automatiquement le certificat SSL.
5. Cliquez sur Deploy, puis ouvrez la fonction Terminal de Coolify pour le conteneur `app` et exécutez `php artisan make:filament-user`.

[](#déployer-avec-dokploy "Permalink")Déployer avec Dokploy
-----------------------------------------------------------

[Dokploy](https://dokploy.com/) suit le même schéma :

1. Créez un projet, ajoutez un service Compose avec la source **Raw** et collez `compose.yml`.
2. Définissez `APP_KEY`, `DB_PASSWORD` et `APP_URL` dans l'onglet Environment du service. Définissez aussi `APP_PORT=8080`. Le tableau de bord de Dokploy occupe en général le port 80, et associer le conteneur de l'application au port 8080 évite le conflit.
3. Cliquez sur Deploy et attendez que les contrôles de santé des cinq conteneurs réussissent.
4. Ajoutez votre domaine dans l'onglet Domains du service app, réglez le port du conteneur sur 8080 et activez HTTPS (Dokploy gère Let's Encrypt).
5. Ouvrez le terminal de Dokploy pour le conteneur `app` et exécutez `php artisan make:filament-user`.

[](#se-passer-de-conteneurs "Permalink")Se passer de conteneurs
---------------------------------------------------------------

Si Docker n'est pas envisageable, Relaticle documente aussi une installation manuelle : cloner le dépôt, `composer install --no-dev --optimize-autoloader`, `pnpm install --frozen-lockfile && pnpm run build`, `php artisan migrate --force`, régler les permissions de `storage` et de `bootstrap/cache`, puis exécuter Horizon sous Supervisor et `schedule:run` depuis cron. C'est la même application, simplement sans la frontière du conteneur. Cela vaut la peine si vous standardisez déjà un parc d'applications Laravel sur serveurs physiques sous un seul gestionnaire de processus. Il n'existe pas de version abrégée, prévoyez donc plutôt une heure et suivez le guide complet.

[](#prérequis-ia--ollama-broadcasting-et-mcp "Permalink")Prérequis IA : Ollama, broadcasting et MCP
---------------------------------------------------------------------------------------------------

Le fichier Compose démarre les services principaux. MCP utilise la route de l'application. Le chat exige en plus des identifiants de modèle, un broadcasting opérationnel et un service Reverb en cours d'exécution. Le fichier Compose de base ne configure pas ces éléments. Considérez ce qui suit comme une aide à la configuration et non comme une recette éprouvée d'un déploiement complet du chat. Vérifiez un tour de chat complet sur votre pile configurée avant de vous y fier.

**Modèle local avec Ollama.** Définissez ces valeurs dans l'environnement de votre déploiement. Transmettez-les aussi dans les sections `environment` de `app` et de `horizon`. Compose ne transmet pas aux conteneurs des entrées `.env` arbitraires. Recréez les services après avoir modifié la configuration. Ces réglages de modèle ne remplacent pas la configuration de Reverb décrite plus haut :

```
OLLAMA_BASE_URL=http://host.docker.internal:11434
OLLAMA_MODEL=qwen3:14b

```

`OLLAMA_BASE_URL` vaut par défaut `http://localhost:11434`, ce qui, depuis l'intérieur d'un conteneur, désigne le conteneur lui-même et non votre hôte. Sous Docker Desktop (Mac ou Windows), `host.docker.internal` atteint l'hôte sans réglage. Sur un serveur Linux, où fonctionnent la plupart des installations auto-hébergées, deux étapes supplémentaires sont nécessaires. Ce nom d'hôte ne se résout que si vous l'ajoutez aux services app et horizon dans votre fichier Compose,

```
extra_hosts:
  - "host.docker.internal:host-gateway"

```

et Ollama n'écoute par défaut que sur l'interface de bouclage. Liez-le à une interface privée accessible depuis les conteneurs, en suivant la [FAQ d'Ollama](https://docs.ollama.com/faq). Si vous le liez à toutes les interfaces avec `OLLAMA_HOST=0.0.0.0`, restreignez le port 11434 au réseau de l'application avec votre pare-feu. N'exposez jamais publiquement un point d'accès Ollama sans authentification. Vous pouvez aussi exécuter Ollama comme un autre service Compose sur le même réseau et faire pointer `OLLAMA_BASE_URL` vers le nom de ce service. Installez d'abord le modèle dans Ollama. Définir `OLLAMA_MODEL` sélectionne son étiquette pour le sélecteur de modèles de l'application, mais ne télécharge aucun fichier de modèle.

Tous les modèles locaux ne méritent pas un accès en écriture. L'assistant dispose de ses propres outils pour rechercher des enregistrements du CRM et proposer des modifications. MCP expose un registre d'outils distinct, et les petits modèles affirment souvent qu'une action a réussi sans avoir appelé l'outil. Avant d'orienter des données réelles vers un modèle, vérifiez-le avec :

```
docker compose exec app php artisan chat:models --probe=ollama

```

Cette commande lance un test rapide des appels d'outils en conditions réelles sur votre point d'accès Ollama. L'estimation de RAM du serveur CRM n'inclut pas l'inférence locale. Vérifiez séparément les besoins en mémoire et en matériel du modèle choisi. Une sonde réussie teste les appels d'outils et non la qualité des réponses pour chaque tâche du CRM. Si vous préférez servir plusieurs modèles à plusieurs utilisateurs en même temps, `SELF_HOSTED_AI_URL`, `SELF_HOSTED_AI_KEY` et `SELF_HOSTED_AI_MODELS` orientent le même sélecteur vers n'importe quel serveur compatible OpenAI (vLLM, LM Studio, LocalAI).

![Le sélecteur de modèles du chat avec des modèles Ollama locaux à côté des entrées Claude et GPT](https://relaticle.com/storage/ink/01M09FYYE6NCKYW6X4Z462GGM2.png)

**MCP server.** Si `MCP_DOMAIN` n'est pas défini, le serveur est accessible à l'adresse `{APP_URL}/mcp` d'emblée, sans étape de déploiement séparée. Créez un jeton d'accès personnel dans **Paramètres → Jetons d'accès** de l'application, puis faites pointer n'importe quel client MCP vers lui :

```
{
  "mcpServers": {
    "relaticle": {
      "type": "streamable-http",
      "url": "https://crm.example.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_TOKEN" }
    }
  }
}

```

L'ensemble des outils comprend les informations sur le compte, la recherche et la récupération entre entités. Il comprend aussi les opérations CRUD sur les entreprises, les personnes, les opportunités, les tâches et les notes. Les ressources de schéma permettent au client de voir vos attributs personnalisés. Rien ne change dans la route entre une installation auto-hébergée et la version hébergée, hormis le domaine vers lequel vous pointez.

[](#ce-à-quoi-vous-renoncez-vraiment-en-auto-hébergeant "Permalink")Ce à quoi vous renoncez vraiment en auto-hébergeant
-----------------------------------------------------------------------------------------------------------------------

L'auto-hébergement des fonctions d'IA a ses limites, et mieux vaut les connaître avant de vous y fier.

- **Le chat auto-hébergé ne consomme aucun crédit depuis la v3.8.1.** Depuis la v3.8.1 (4 novembre 2026), une installation auto-hébergée ne décompte aucun crédit. Tous les modèles configurés sont disponibles. Le chat conserve une limite par minute, que `CHAT_RATE_LIMIT_PER_MINUTE` modifie ou désactive. Jusqu'à la v3.8.0, le chat auto-hébergé était décompté en crédits, même avec votre propre clé d'API ou un modèle local. Un nouvel espace de travail recevait l'allocation gratuite de 300 crédits par mois calendaire. Sur ces versions, le panneau `sysadmin` de toute l'instance (`{APP_URL}/sysadmin`, avec le compte créé plus haut) peut ajuster le solde d'un espace de travail ou changer son offre, sans compte Stripe.

    ![La page des soldes de crédits du panneau sysadmin, jusqu'à la v3.8.0, avec les actions Adjust et Reset period par espace de travail](https://relaticle.com/storage/ink/01M09FZ0J61P4D2TPPCEV27EJJ.png)
- **Chaque réponse dispose d'un budget de 120 secondes.** Si un modèle ne termine pas à temps, le tour s'arrête proprement : votre message reste dans la conversation avec un avis clair et rien n'est perdu en silence. Les modèles « à raisonnement » comme `qwen3` réfléchissent avant de répondre et atteignent ce plafond plus souvent. Un modèle plus petit ou plus rapide, ou un GPU, aide.
- **Le contrôle des appels d'outils en parallèle varie selon le fournisseur.** Relaticle désactive les appels d'outils en parallèle dans ses intégrations Anthropic et OpenAI. Cette restriction ne s'applique pas à ses intégrations auto-hébergées. Un tour peut contenir plusieurs étapes proposées, et les écritures exigent toujours une approbation. Relisez la proposition complète avant de l'approuver.
- **La fiabilité des appels d'outils varie beaucoup selon le modèle.** C'est la raison d'être de `chat:models --probe`. Lancez-le avant de confier de vraies écritures à un nouveau modèle local ou auto-hébergé. Vous éviterez de découvrir à vos dépens qu'un petit modèle a silencieusement ignoré une suppression qu'il disait avoir effectuée.

L'approbation ne couvre que l'assistant intégré, et jusqu'à la v3.8.0 il en allait de même du décompte. L'usage direct de MCP ne consomme pas le solde de crédits de l'assistant intégré, mais votre client MCP ou votre fournisseur de modèles peut facturer séparément.

[](#pour-aller-plus-loin "Permalink")Pour aller plus loin
---------------------------------------------------------

Sauvegardez ensemble PostgreSQL, les fichiers téléversés, la configuration du déploiement et la `APP_KEY` d'origine. Arrêtez les processus qui écrivent dans l'application pendant que vous réalisez les copies de la base de données et du stockage.

Pour un exercice de restauration, utilisez un déploiement séparé avec une base de données vide. Restaurez la base de données avant de démarrer l'application et d'exécuter ses migrations automatiques.

Utilisez `psql -v ON_ERROR_STOP=1` pour que les erreurs SQL fassent échouer l'import. Restaurez les fichiers téléversés et leurs propriétaires, puis vérifiez les relations, les valeurs chiffrées et les octets des pièces jointes.

Gardez les intégrations sortantes bloquées et les workers arrêtés tant que les vérifications de restauration n'ont pas réussi. Conservez l'image d'origine et les secrets de chiffrement pendant tout l'exercice.

La référence des variables d'environnement, les conseils de déploiement et le dépannage des boucles de redémarrage et des migrations en échec se trouvent dans le guide d'auto-hébergement : [relaticle.com/developers/self-hosting](https://relaticle.com/fr/developers/self-hosting). Pour la liste complète des outils MCP, les ressources de schéma et la configuration de Claude Desktop, Claude Code, Cursor et VS Code, consultez [relaticle.com/developers/mcp](https://relaticle.com/fr/developers/mcp).

 Tags [ #self-hosting ](https://relaticle.com/fr/blog/tag/self-hosting) [ #mcp ](https://relaticle.com/fr/blog/tag/mcp) 

 Sur cette page

 Continuer la lecture

 Articles associés. 
--------------------

- [  17 nov. 2026  Guides 

    ###  Un agent IA a supprimé des enregistrements CRM : peut-on les récupérer ? 

    Si un agent IA a supprimé des enregistrements CRM, la récupération dépend du CRM. Nous comparons HubSpot, Salesforce, Attio et Relaticle, et testons une restauration dans Relaticle.

     ![](https://relaticle.com/storage/ink/01M7T5H3D3XANHYC9H4395RVXA.png) 

     ](https://relaticle.com/fr/blog/un-agent-ia-a-supprime-des-enregistrements-crm-les-recuperer)
- [  13 nov. 2026  Guides 

    ###  Connecteurs ChatGPT pour votre CRM : configuration sûre 

    Les connecteurs ChatGPT sont désormais des apps dans des plugins. Connectez chaque espace de travail du CRM une seule fois, vérifiez ce que votre rôle permet et sachez comment révoquer la connexion.

     ![](https://relaticle.com/storage/ink/01M7T5CV1S0HWHTJZ93N8HGCVZ.png) 

     ](https://relaticle.com/fr/blog/connecteurs-chatgpt-pour-votre-crm-configuration-sure)
- [  9 nov. 2026  Guides 

    ###  Permissions de Claude Code : où finit votre jeton CRM 

    Les permissions de Claude Code peuvent enregistrer un secret en clair. Nos tests montrent où un jeton CRM est stocké et pourquoi OAuth évite son enregistrement dans vos fichiers de configuration.

     ![](https://relaticle.com/storage/ink/01M7T1DNP44ZS86YPZG635WEHS.png) 

     ](https://relaticle.com/fr/blog/permissions-claude-code-ou-finit-votre-jeton-crm)
