# Ce que fait Fransys > Un PaaS européen opéré. Vous décrivez votre application, Fransys la met en ligne sur des machines chez un hébergeur européen, la surveille et la fait grandir sous un plafond de budget. Source : https://docs.fransys.cloud/demarrer/ce-que-fait-fransys/ Vérifié sur la console le 2026-10-23. ## En une phrase Vous décrivez votre application dans la console : son code, sa base de données, son domaine. Fransys réserve les machines chez l'hébergeur européen de votre choix, installe Kubernetes, déploie l'application avec une adresse en HTTPS, puis la surveille et la sauvegarde. Vous n'écrivez ni YAML ni configuration de serveur. ## Ce que Fransys prend en charge - **Les machines** : Fransys les commande chez l'hébergeur (Hetzner, Scaleway, Outscale ; OVHcloud bientôt), sur son compte ou sur le vôtre. - **Kubernetes** : installé, mis à jour et opéré pour vous. Vous choisissez une [criticité](https://docs.fransys.cloud/clusters/criticite/), Fransys en déduit le nombre de machines. - **Le déploiement** : depuis une image Docker ou un dépôt GitHub ou GitLab. Si un contrôle échoue, Fransys revient en arrière tout seul et la version précédente reste en ligne. - **Le réseau** : répartiteur de charge, adresse en `fransysapp.com`, votre domaine, certificats HTTPS. - **Les bases de données** : PostgreSQL, MariaDB et Redis, managées et sauvegardées. - **Le suivi** : santé des services, journaux, processeur et mémoire, dans la page Monitoring. - **Le budget** : un prix affiché avant chaque création, un plafond par cluster, des crédits consommés à l'heure. ## L'agent prépare, vous validez Votre agent (Claude Code, Cursor, Codex…) se branche sur Fransys par le MCP. Il lit vos projets, vos journaux et vos mesures, et prépare des **plans** : une liste d'actions chiffrée. Un plan ne fait rien tant qu'une personne de l'équipe ne l'a pas validé dans la console. Voir [Brancher un agent](https://docs.fransys.cloud/agents/brancher-un-agent/) et [Les plans](https://docs.fransys.cloud/agents/plans/). ## Où sont vos données Dans le pays et chez l'hébergeur que vous choisissez à la création du cluster. La console signale les régions hors Union européenne, et vous pouvez n'afficher que les régions de l'Union. ## Ce que Fransys ne fait pas - **Pas d'hébergement de données de santé (HDS).** Fransys n'est pas certifié HDS. - **SecNumCloud** est une qualification de l'hébergeur Outscale, pas de Fransys. - Fransys n'écrit pas votre code. L'agent peut vous dire quoi changer dans votre dépôt (un port, une variable), mais il ne pousse rien. ## Besoin d'aide Le bouton d'aide, en haut de la console, ouvre une discussion avec l'équipe Fransys. Vous pouvez aussi écrire à kevin@fransys.cloud. --- # Premier déploiement > Une première application en ligne, en HTTPS, sur un cluster européen. Le parcours « Premier lancement » de la console, étape par étape. Source : https://docs.fransys.cloud/demarrer/premier-deploiement/ Vérifié sur la console le 2026-10-23. ## Avant de commencer Il vous faut un compte Fransys et des crédits : votre solde s'affiche dans la colonne de gauche du parcours. Les crédits paient ce que consomment vos machines, à l'heure ; il n'y a pas d'abonnement. Pour en ajouter, voir [Crédits et paiement automatique](https://docs.fransys.cloud/budget/credits-et-paiement-automatique/). Le parcours **Premier lancement** s'ouvre juste après l'inscription. Il compte quatre étapes : **Votre premier service**, **Où l'héberger**, **Mise en ligne**, **Et ensuite**. Vous pouvez le passer avec **Passer, aller au tableau de bord**. ## Les étapes 1. **Choisir votre premier service** Trois choix : - **Une page nginx** : le plus simple pour voir toute la chaîne fonctionner. Vous la remplacerez ensuite. - **Votre image Docker** : publiée sur Docker Hub, GitHub ou un autre registre public. Indiquez l'image (par exemple `ghcr.io/votre-equipe/app:latest`) et, si besoin, le port écouté par l'application. - **Depuis un dépôt Git** : pas encore dans ce parcours. Voir [Déployer votre code](https://docs.fransys.cloud/demarrer/deployer-votre-code/). Une image privée ? Vous ajouterez l'accès au registre dans les réglages du service, après le parcours. 2. **Choisir où l'héberger** - **Sur un cluster déjà en ligne** : aucune machine en plus, le service partage ce cluster avec vos autres projets. - **Sur un nouveau cluster** : le plus petit que l'hébergeur accepte. Vous pourrez l'agrandir ensuite. La console affiche le coût par mois tant que le cluster tourne, et combien de temps vos crédits le couvrent. Donnez un nom au projet. 3. **Mettre en ligne** Relisez le récapitulatif, puis cliquez sur **Mettre en ligne**. Fransys enchaîne : - réserver les machines chez l'hébergeur ; - installer Kubernetes (jusqu'à 15 minutes) ; - créer le projet et préparer le service ; - déployer, puis vérifier que le service répond. Vous pouvez fermer la page : l'installation continue, et la console vous prévient quand le service répond. 4. **Ouvrir votre application** L'adresse du service apparaît dans ses réglages, onglet **Général**. Elle est déjà en HTTPS. > **La facturation commence dès que les machines tournent** > Un nouveau cluster consomme vos crédits dès que ses machines sont créées, même si le service n'est pas encore en ligne. ## Si une étape bloque Le parcours affiche **Une étape a bloqué**, avec la raison. Corrigez ce qui est indiqué, puis cliquez sur **Reprendre** : le parcours repart de l'étape bloquée, rien n'est recréé. Les raisons les plus courantes : - **Le service ne démarre pas** : son journal dira pourquoi. Ouvrez le service, puis sa pastille d'état. - **Le cluster met plus de 25 minutes à démarrer** : écrivez-nous depuis le bouton d'aide. Juste après sa création, le cluster peut rester quelques minutes **Dégradé**. C'est normal : vous pouvez déjà déployer. ## La carte « Pour démarrer » Sur la page **Aujourd'hui**, la carte **Pour démarrer** propose le même chemin en cinq étapes, environ 20 minutes : brancher votre IA (facultatif), créer votre projet, créer votre cluster, déployer, puis faire une première mise à jour. Chaque étape propose aussi une phrase à donner à votre agent. Vous la retrouvez dans le menu de votre compte, **Pour démarrer**. ## Et ensuite - [Ajouter une base de données](https://docs.fransys.cloud/projets/bases-de-donnees/) : PostgreSQL, MariaDB ou Redis, reliée à votre service. - [Déployer depuis GitHub ou GitLab](https://docs.fransys.cloud/demarrer/deployer-votre-code/) plutôt qu'une image. - [Mettre votre domaine](https://docs.fransys.cloud/projets/domaine-et-https/). - [Brancher votre agent](https://docs.fransys.cloud/agents/brancher-un-agent/). --- # Déployer votre code > Mettre en ligne une application depuis un dépôt GitHub ou GitLab, construite à chaque push par l'intégration continue de Fransys. Source : https://docs.fransys.cloud/demarrer/deployer-votre-code/ Vérifié sur la console le 2026-10-23. ## Le principe Fransys construit l'image Docker de votre application à chaque push, puis la déploie. Pour cela, il ouvre sur votre dépôt une merge request qui ajoute son pipeline. Votre code n'est pas modifié. Il faut un projet rattaché à un cluster. Si vous n'en avez pas encore, suivez d'abord le [Premier déploiement](https://docs.fransys.cloud/demarrer/premier-deploiement/). ## Les étapes 1. **Ajouter le service** Dans le projet, cliquez sur **Ajouter un service**, puis **Application**. Fransys prépare ses réglages en une à deux minutes. 2. **Choisir l'origine du code** Dans le panneau du service, réglez l'origine du code sur GitHub ou GitLab. Cliquez sur **Relier GitHub** (ou GitLab) si votre compte n'est pas encore relié, puis choisissez le dépôt et la branche. 3. **Brancher l'intégration continue** Cliquez sur **Brancher la CI**, puis **Créer la merge request**. Sur votre dépôt : - suivez les consignes de la merge request ; - mergez-la ; - attendez la fin du pipeline : votre dernier commit apparaît alors dans le service. Fransys ajoute ses propres éléments de CI sans toucher à l'existant, et des variables préfixées `FRANSYS_` dans le dépôt. 4. **Dire à Fransys comment lancer l'application** Le guide **Il reste à dire à Fransys comment lancer votre application** demande trois choses : - **le port** sur lequel l'application répond ; - **ses variables** : clé de l'application, accès à la base, e-mails… ; - **ses voisins** : base de données, cache, files d'attente. Le plus simple est de le demander à votre agent (voir plus bas). Sinon, faites-le à la main : réglez le port du conteneur, importez votre `.env.example` dans les [variables](https://docs.fransys.cloud/projets/variables-et-secrets/), et [ajoutez les bases reliées](https://docs.fransys.cloud/projets/bases-de-donnees/). 5. **Déployer** Cliquez sur **Déployer**. Voir [Déployer et suivre](https://docs.fransys.cloud/projets/deployer-et-suivre/). ## Le faire préparer par votre agent Ouvrez votre agent dans le dossier du dépôt et donnez-lui la consigne que propose le guide (bouton **Copier la consigne**). L'agent lit le Dockerfile, le docker-compose et le `.env.example`, puis prépare un plan : port, variables, bases à ajouter et à relier. Rien ne change sans votre accord : vous relisez le plan dans la console avant de l'exécuter. Voir [Les plans](https://docs.fransys.cloud/agents/plans/). Pour les autres processus (files d'attente, websocket), l'agent copie le service et choisit son rôle par une variable d'environnement : Fransys ne permet pas de changer la commande du conteneur. Pour les tâches planifiées, il utilise une commande récurrente. ## Variables lues au build Les variables lues au moment du build (par exemple `VITE_…`) ne sont pas encore transmises par la CI de Fransys. Gardez-les dans votre code, ou lisez-les au démarrage de l'application. ## Votre commit n'arrive pas Voir [Dernier commit non importé](https://docs.fransys.cloud/projets/github-gitlab/#dernier-commit-non-importé). --- # Les mots de Fransys > Projet, service, cluster, plan, crédits… Ce que veut dire chaque mot de la console, en une ou deux phrases. Source : https://docs.fransys.cloud/demarrer/les-mots-de-fransys/ Vérifié sur la console le 2026-10-23. ## Votre application - **Projet** : votre application. Il regroupe ses services (images Docker, bases de données…) et se déploie sur un cluster. Un projet est en ligne ou hors ligne. - **Service** : un élément du projet : une application (image Docker ou dépôt Git), une base de données, ou un autre type (WebSocket, gestionnaire de secrets…). Chaque service a son panneau de réglages. - **Schéma** : la vue du projet qui montre ses services et leurs liaisons. La vue **Liste** montre les mêmes services en tableau. - **Liaison** : le lien entre deux services. Relier une application à une base lui donne les variables de connexion de la base. - **Changement à déployer** : un réglage enregistré mais pas encore appliqué. Il part au prochain déploiement du projet. - **Déploiement** : l'application des changements sur le cluster, service par service. Si un contrôle échoue, Fransys revient en arrière : la version précédente reste en ligne. ## Les machines - **Cluster** : un ensemble de machines chez l'hébergeur de votre choix. Fransys y installe et opère Kubernetes ; vos projets s'y déploient. - **Criticité** : Basique, Stable ou Critique. Elle fixe le minimum de machines que Fransys installe pour faire tenir le cluster. Voir [Criticité](https://docs.fransys.cloud/clusters/criticite/). - **Nœud de contrôle** : la machine qui pilote le cluster. - **Machine de travail (worker)** : une machine où tournent vos services. - **Répartiteur de charge** : il reçoit le trafic et le répartit entre les machines. - **AutoPilot** : Fransys choisit les machines et en ajoute selon la charge, sans dépasser votre plafond. - **Plafond (budget maximum)** : ce qu'un cluster en AutoPilot ne doit jamais dépasser par mois. Ce n'est pas une dépense visée. - **Compte cloud** : votre propre compte chez un hébergeur. Les machines tournent alors sur votre compte, facturées par l'hébergeur. ## Les agents - **MCP Fransys** : le serveur qui permet à votre agent (Claude Code, Cursor…) de lire Fransys et de préparer des plans. - **Clé d'agent** : la clé avec laquelle un agent se connecte. Elle ne donne que des droits de lecture. - **Plan** : une liste d'actions, préparée par un agent ou depuis la console, avec son effet et son coût. Rien ne s'exécute avant qu'une personne le valide. Voir [Les plans](https://docs.fransys.cloud/agents/plans/). - **Journal** : qui a fait quoi, quand : chaque modification et chaque plan y laisse une trace. ## L'argent - **Crédits** : 1 crédit = 1 €. Ils paient la consommation, à l'heure, tant que des machines tournent. - **Période** : le mois de facturation. Un relevé de consommation est émis à la fin de chaque période. - **Paiement automatique** : ce qui dépasse vos crédits est réglé en fin de période sur votre moyen de paiement. L'infrastructure n'est alors jamais coupée. - **Limite mensuelle** : le total que la période ne doit pas dépasser. --- # Avant la production > La liste à parcourir avant d'ouvrir votre application au public : cluster, code, base, variables, domaine, budget, accès. Source : https://docs.fransys.cloud/demarrer/avant-la-production/ Vérifié sur la console le 2026-10-23. ## Le cluster - [ ] La criticité est **Stable** ou **Critique**, pas **Basique**. Voir [Criticité](https://docs.fransys.cloud/clusters/criticite/). - [ ] La région est celle que vous voulez pour vos données. - [ ] Le pilotage est réglé : AutoPilot avec un plafond qui laisse de la marge, ou des machines fixes bien dimensionnées. - [ ] Le cluster est **En ligne**, toutes ses machines prêtes. ## Le code - [ ] Le service est relié à votre dépôt, la merge request de la CI est mergée, et le pipeline passe. - [ ] Un push déploie bien la nouvelle version. - [ ] Les sondes de démarrage et de disponibilité laissent à l'application le temps de démarrer. ## La base de données - [ ] La base est managée par Fransys et reliée à l'application (pas de conteneur de base fait maison). - [ ] La fréquence et la durée de conservation des sauvegardes vous conviennent, et une sauvegarde **terminée** existe. - [ ] Vous avez essayé une restauration, sur une base de test. - [ ] L'accès à distance est coupé. ## Les variables - [ ] Aucun secret dans le code ni dans l'image : tout passe par des variables **protégées**. - [ ] Les variables de connexion viennent des liaisons, pas de valeurs recopiées. ## Le domaine - [ ] Votre domaine est ajouté, l'enregistrement DNS créé, et le cadenas HTTPS s'affiche. ## Le budget - [ ] Le paiement automatique est actif, avec une limite mensuelle vérifiée. Voir [Ne jamais être coupé](https://docs.fransys.cloud/budget/ne-jamais-etre-coupe/). - [ ] Les coordonnées de facturation sont renseignées. ## Les accès - [ ] La double authentification est active sur les comptes de l'équipe. - [ ] Chaque agent a sa propre clé, et les clés inutiles sont retirées. ## Le suivi - [ ] La page **Monitoring** est au vert, sans redémarrages à répétition. - [ ] Le journal du service ne montre pas d'erreur au démarrage. --- # Projets > Un projet, c'est votre application. Le créer, le rattacher à un cluster, le lire d'un coup d'œil, le mettre hors ligne ou le supprimer. Source : https://docs.fransys.cloud/projets/projets/ Vérifié sur la console le 2026-10-23. ## Ce qu'est un projet Un projet est votre application. Il regroupe ses services (images Docker, bases de données…) et se déploie sur un cluster. Plusieurs projets peuvent partager le même cluster. ## Créer un projet Dans **Projets**, cliquez sur **Nouveau projet**, puis donnez-lui un nom. Le projet est créé vide et hors ligne. Ensuite : 1. rattachez-le à un cluster ; 2. ajoutez-y des services ([Application](https://docs.fransys.cloud/projets/application/), [base de données](https://docs.fransys.cloud/projets/bases-de-donnees/)…) ; 3. déployez. ## Rattacher le projet à un cluster Sur la page du projet, cliquez sur **Choisir un cluster** : c'est là que ses services tourneront. Vous pouvez aussi le faire depuis la page du cluster, avec **Rattacher un projet**. Un projet ne change de cluster que s'il est hors ligne. Pour le déplacer : mettez-le hors ligne, puis **Changer de cluster**, puis redéployez. Les données de ses bases ne suivent pas : voir [Sauvegardes et restauration](https://docs.fransys.cloud/exploiter/sauvegardes/). ## Lire la page d'un projet En tête, **L'essentiel** : - les services en ligne sur le total ; - **Ce projet coûte** : sa part du cluster, par mois ; - le dernier déploiement, avec son historique. Puis les **Services**, en **Schéma** ou en **Liste**, la **Consommation** et l'**Activité**. L'onglet **Déploiements** liste les versions déployées. Quand des réglages attendent, une barre **Changements à déployer** apparaît. Voir [Déployer et suivre](https://docs.fransys.cloud/projets/deployer-et-suivre/). ## Les états d'un projet - **Hors ligne** : rien ne tourne. - **Mise en ligne en cours** : un déploiement s'applique. - **Tout est en ligne.** - **Un service demande votre attention** : il ne démarre pas, ou un contrôle de santé échoue. Ouvrez-le pour voir pourquoi. - **Arrêt en cours** : la mise hors ligne s'applique. ## Mettre un projet hors ligne Dans le menu du projet, choisissez la mise hors ligne, puis tapez le nom du projet pour confirmer. Tous ses services s'arrêtent. Le projet et sa configuration restent dans Fransys : vous pourrez le redéployer. > **Les bases perdent leurs données** > Les services avec état, comme les bases de données, perdent toutes leurs données à la mise hors ligne. Faites une sauvegarde avant si vous en avez besoin, ou réglez leur source de restauration sur elles-mêmes : voir [Sauvegardes et restauration](https://docs.fransys.cloud/exploiter/sauvegardes/). Un projet hors ligne ne coûte rien en lui-même, mais son cluster continue de tourner et d'être facturé tant que vous ne le mettez pas hors ligne lui aussi. ## Renommer ou supprimer - **Renommer** : 30 caractères au plus. Seul le nom change. - **Supprimer** : le projet, ses services et leur configuration sont supprimés. C'est définitif. --- # Application > Le service qui fait tourner votre code, à partir d'une image Docker ou d'un dépôt Git. L'ajouter, le régler, le désactiver. Source : https://docs.fransys.cloud/projets/application/ Vérifié sur la console le 2026-10-23. ## Ajouter une application Dans le projet, cliquez sur **Ajouter un service**, puis **Application** : à partir d'une image Docker, construite par votre CI ou publiée sur un registre. N'importe quel langage, n'importe quel framework. Le service est créé avec sa configuration par défaut. Fransys ajoute ses réglages (image, port, adresse…) en une à deux minutes ; ils s'affichent tout seuls dans le panneau. Rien ne tourne avant le déploiement du projet. ## Image Docker ou dépôt Git Dans l'onglet **Général**, l'**Origine du code** décide d'où vient l'image : - **Image externe** : indiquez l'**Image Docker**, par exemple `ghcr.io/votre-equipe/app:latest`. Pour une image privée, voir plus bas ; - **GitHub ou GitLab** : Fransys construit l'image à chaque push. Voir [Depuis GitHub ou GitLab](https://docs.fransys.cloud/projets/github-gitlab/). Après ce choix, de nouveaux réglages peuvent apparaître au bout de quelques secondes : la console affiche **Mise à jour des réglages…** en attendant. ## Régler le service Le panneau range les réglages en onglets : | Onglet | Ce qu'on y règle | |---|---| | **Général** | La plateforme, l'origine du code, l'image Docker, le port du conteneur, le registre privé. | | **Ressources** | Le processeur et la mémoire par réplique (réservations et limites), le nombre de répliques, le GPU. | | **Stockage** | Les volumes : point de montage et taille. | | **Variables** | Les variables d'environnement. Voir [Variables et secrets](https://docs.fransys.cloud/projets/variables-et-secrets/). | | **Commandes de déploiement** | Les commandes lancées avant ou après la première installation, avant ou après une mise à jour. | | **Tâches planifiées** | Les commandes récurrentes. Voir [Tâches planifiées](https://docs.fransys.cloud/projets/taches-planifiees/). | | **Réseau** | L'accès depuis Internet, les domaines, les redirections, l'IP de sortie. | | **Sécurité** et **Avancé** | Le contexte de sécurité du conteneur et du pod, le compte de service Kubernetes, les sondes, les annotations et étiquettes. | Le champ **Chercher un réglage** trouve un réglage par son nom (port, domaine, mémoire…). Un onglet vide se remplit selon les choix des autres onglets. - Chaque réglage est enregistré dès que vous quittez le champ. - Il s'applique au prochain déploiement du projet. - Un réglage obligatoire vide bloque le déploiement : il est signalé **Obligatoire pour déployer**. ## Image privée Dans **Général**, activez **Registre privé (authentification)**, puis renseignez l'**Identifiant du registre** et le **Mot de passe du registre**. Le mot de passe est chiffré : une fois enregistré, vous ne pourrez plus le relire. ## Ressources et répliques - **Réservations** : ce que chaque réplique obtient à coup sûr, en processeur et en mémoire. C'est ce qui occupe de la place sur les machines du cluster. - **Limites** : ce qu'une réplique ne peut pas dépasser. Sans limite, elle prend ce qui est libre. - **Nombre de répliques** : en mode **Fixe**, le nombre que vous choisissez ; en mode **Automatique**, Fransys en ajoute selon la charge. Voir [Montée en charge](https://docs.fransys.cloud/clusters/montee-en-charge/). - **GPU** : **Aucun** ou **NVIDIA**, sur un cluster qui a des machines à GPU. Voir [GPU](https://docs.fransys.cloud/clusters/gpu/). ## Commandes de déploiement Pour lancer une commande au bon moment (migrations de base, vidage de cache…), ajoutez-la dans **Commandes de déploiement**, à l'un des quatre moments : - **Avant la première installation** et **Après la première installation** ; - **Avant une mise à jour** et **Après une mise à jour**. L'**Ordre d'exécution** range plusieurs commandes du même moment. ## Sondes Dans **Avancé**, la **Sonde de démarrage**, la **Sonde de vie** et la **Sonde de disponibilité** disent à Fransys quand le service est prêt à recevoir du trafic, et quand le redémarrer. Si votre application met du temps à démarrer, réglez la sonde de démarrage plutôt que de la couper. ## Adresse publique ou interne Dans **Réseau**, **Accessible depuis Internet** décide si le service a une adresse publique. Une application publique reçoit une adresse en `fransysapp.com`, en HTTPS. Sur le schéma, le lien de la carte l'ouvre dans un nouvel onglet. Un service **Interne au projet** n'a pas d'adresse publique : seuls les services du projet peuvent le joindre. ## Workers, files d'attente, tâches planifiées Fransys ne permet pas de changer la commande du conteneur. Pour faire tourner un autre processus de la même application (file d'attente, websocket) : - copiez le service, puis choisissez son rôle par une variable d'environnement que lit votre point d'entrée. Votre agent sait préparer cette copie dans un plan ; - pour une tâche planifiée, ajoutez une commande récurrente : voir [Tâches planifiées](https://docs.fransys.cloud/projets/taches-planifiees/). ## IP fixe de sortie Par défaut, le service sort sur Internet avec une adresse dynamique, partagée. Si un partenaire doit autoriser votre adresse, réglez l'**IP de sortie** (onglet **Réseau**) sur une **Nouvelle IP fixe**. Une IP fixe appartient à l'organisation : plusieurs services peuvent l'utiliser. Chaque IP fixe déployée est facturée chaque mois (voir la [grille tarifaire](https://docs.fransys.cloud/budget/grille-tarifaire/)). Supprimer une IP fixe est irréversible : l'adresse est libérée et vous ne pourrez peut-être pas la récupérer. ## Processeurs ARM Sur un cluster aux machines ARM, vos images Docker doivent être construites pour `arm64`. ## Désactiver, renommer, supprimer - **Service actif** : désactivé, le service n'est plus déployé, mais sa configuration est gardée. - **Renommer le service** : seul le nom change. - **Supprimer le service** : le service et sa configuration sont retirés du projet. S'il tourne, il est arrêté au prochain déploiement. --- # Depuis GitHub ou GitLab > Relier votre compte GitHub ou GitLab, brancher l'intégration continue de Fransys, et que faire quand un commit n'arrive pas. Source : https://docs.fransys.cloud/projets/github-gitlab/ Vérifié sur la console le 2026-10-23. ## Relier votre compte Dans le panneau du service, avec l'origine du code sur GitHub ou GitLab, cliquez sur **Relier GitHub** (ou **Relier GitLab**). Fransys n'utilise ce compte que pour importer votre code et préparer l'intégration continue. - **Plusieurs comptes reliés** : choisissez celui du service. - **Un dépôt n'apparaît pas** : **Autoriser d'autres dépôts** rouvre l'autorisation chez GitHub ou GitLab pour choisir les dépôts accessibles à Fransys. - **Gérer vos comptes** : dans **Mon compte**, rubrique des comptes de code. Si le compte d'un service n'est plus relié (délié, ou accès retiré chez GitHub ou GitLab), la console le signale dans le service : reliez-le à nouveau. ## Brancher l'intégration continue Cliquez sur **Brancher la CI**. Fransys ouvre une merge request qui ajoute son pipeline à votre dépôt. Une fois mergée, chaque push construit l'image et la déploie. 1. Créez la merge request. 2. Suivez ses consignes. 3. Vérifiez qu'elle est mergée. 4. Attendez la fin du pipeline : votre dernier commit apparaît alors dans le service. Ce que fait la merge request : - votre code n'est pas modifié ; - Fransys ajoute ses propres éléments de CI, sans toucher à l'existant ; - des variables d'environnement préfixées `FRANSYS_` sont ajoutées au dépôt. Pas de merge request sur votre dépôt ? **Recréer la merge request**. ## Dernier commit non importé Si votre code n'est toujours pas importé 10 minutes après votre dernier commit : - consultez le journal du dernier job CI de votre dépôt ; - vérifiez que Fransys a toujours accès au dépôt, dans **Mon compte** ; - si le problème persiste, écrivez à l'équipe depuis le bouton d'aide. ## Variables lues au build Les variables lues au moment du build (par exemple `VITE_…`) ne sont pas encore transmises par la CI de Fransys. Gardez-les dans votre code, ou lisez-les au démarrage. --- # PostgreSQL, MariaDB, Redis > Ajouter une base de données managée et sauvegardée, la relier à votre application, et ce qui arrive à ses données. Source : https://docs.fransys.cloud/projets/bases-de-donnees/ Vérifié sur la console le 2026-10-23. ## Ajouter une base Dans le projet, cliquez sur **Ajouter un service**, puis **Base de données** : managée par Fransys, avec sauvegardes. Choisissez le moteur : PostgreSQL, MariaDB ou Redis. Plus rapide : depuis une application, **Ajouter un service relié**. La nouvelle base est reliée à l'application dès que Fransys l'a préparée (jusqu'à 2 minutes). Sur le schéma, la carte d'une base affiche son moteur, sa version et la taille de son disque. ## Régler la base - **Moteur** et, pour PostgreSQL, **Version de PostgreSQL**. - **Taille du disque** : l'espace des données. Les volumes sont facturés au Go (voir la [grille tarifaire](https://docs.fransys.cloud/budget/grille-tarifaire/)). - **Au premier démarrage** : **Base vide**, ou **Depuis une sauvegarde** (voir [Sauvegardes et restauration](https://docs.fransys.cloud/exploiter/sauvegardes/)). - **Fréquence des sauvegardes** et **Durée de conservation (jours)**. ## La relier à votre application Relier une application à une base lui injecte les variables de connexion de la base : adresse, port, identifiants. Voir [Relier des services](https://docs.fransys.cloud/projets/relier-des-services/). Par défaut, une base n'a pas d'adresse publique : seuls les services du projet peuvent la joindre. ## Accès à distance Pour joindre la base depuis votre poste (un client SQL, une migration ponctuelle), activez **Autoriser l'accès à distance à la base**. Coupez-le dès que vous n'en avez plus besoin : une base ouverte sur Internet n'est protégée que par ses identifiants. > **Deux bases du même moteur** > Si une application est reliée à deux bases du même moteur (deux Redis, par exemple), elles donnent les mêmes noms de variables. Fransys refuse de déployer tant que vous n'en avez pas renommé, dans le panneau du service qui les reçoit. ## Sauvegardes Les bases PostgreSQL, MariaDB et Redis sont sauvegardées automatiquement, selon la **Fréquence des sauvegardes** et la **Durée de conservation** de la base. Le panneau liste ses dernières sauvegardes, avec leur taille et leur statut. Pour restaurer, voir [Sauvegardes et restauration](https://docs.fransys.cloud/exploiter/sauvegardes/). ## Ce qui efface les données - **Supprimer la base** : ses données sont supprimées au prochain déploiement. - **Mettre le projet ou le cluster hors ligne** : la base perd ses données. À la remise en ligne, elle repart de sa dernière sauvegarde seulement si sa source de restauration est réglée sur elle-même ; sinon, elle repart vide. - **Délier la base** d'une application : les données restent intactes. L'application ne reçoit plus les variables de connexion. --- # Relier des services > Ce qui passe d'un service à l'autre quand on les relie, comment relier et délier, et renommer une variable reçue. Source : https://docs.fransys.cloud/projets/relier-des-services/ Vérifié sur la console le 2026-10-23. ## Ce qui passe par une liaison - **D'une base vers une application** : les variables de connexion de la base (adresse, port, identifiants). - **D'une application vers une autre** : les variables que la première partage. Pour partager une variable, cochez **Exposer aux services reliés** sur cette variable. Si aucun des deux services ne partage de variable, rien ne passe : la console le dit avant de relier. ## Relier deux services - **Sur le schéma** : glissez la poignée d'un service jusqu'à l'autre, ou cliquez dessus pour choisir le service. - **Dans le panneau** : onglet **Connexions**, **Relier à…**. - **Sur téléphone** : la feuille **Relier … à…**. Une confirmation dit ce que chaque service recevra. La liaison est prise en compte au prochain déploiement du projet. ## Renommer une variable reçue Dans le panneau du service qui reçoit, une variable reçue porte la mention **reçue d'un service relié**. Vous pouvez lui donner un autre nom dans ce service ; videz le champ pour reprendre le nom d'origine. C'est le moyen de relier une application à deux bases du même moteur : Fransys refuse de déployer tant que deux variables reçues portent le même nom. ## Délier Survolez la liaison sur le schéma, ou passez par l'onglet **Connexions**, puis **Délier**. Au prochain déploiement : - le service qui recevait les variables ne les reçoit plus. S'il s'en sert, il ne pourra plus démarrer correctement ; - les données d'une base restent intactes ; - si vous reliez à nouveau ces services, les variables reviennent sous leur nom d'origine : les renommages sont perdus. Rien ne change avant le prochain déploiement. --- # Variables et secrets > Ajouter des variables d'environnement une à une ou depuis un fichier .env, protéger un secret, citer une autre variable, exporter. Source : https://docs.fransys.cloud/projets/variables-et-secrets/ Vérifié sur la console le 2026-10-23. ## Ajouter une variable Dans le panneau du service, rubrique des variables d'environnement, mode **Une variable** : un nom, une valeur, puis **Ajouter**. La variable s'applique au prochain déploiement du projet. Trois options par variable : - **Exposer aux services reliés** : les services reliés à celui-ci reçoivent cette variable ; - **Protégée** : la valeur est chiffrée et illisible ensuite, même pour vous. Gardez-en une copie en lieu sûr ; - **Autoriser les références** : la valeur peut citer une autre variable, par exemple `${APP_URL}/api`. Elle est remplacée au déploiement. ## Importer un fichier .env Mode **Plusieurs variables (.env)** : collez le contenu du fichier, une variable par ligne (`CLE=valeur`). Les commentaires `#`, les valeurs entre guillemets et les lignes vides sont acceptés. Les noms sont mis en majuscules. L'**Aperçu avant import** montre les variables reconnues, celles déjà présentes et les lignes ignorées, avec la raison (pas de signe `=`, guillemet jamais fermé…). Pour chaque nom déjà présent, choisissez : - garder la valeur actuelle ; - remplacer la valeur actuelle ; - importer sous un autre nom (suffixe `_2`). Les options (exposée, protégée, références) s'appliquent à toutes les variables importées. Gardez le panneau ouvert jusqu'à la fin de l'import. ## Exporter **Exporter les variables** donne le contenu au format `.env`, à copier ou à télécharger. Les valeurs protégées ne sont pas lisibles : elles figurent en commentaire (`# CLE=`), à compléter à la main. Les variables reçues des services reliés ne sont pas incluses. ## Variables reçues Les variables qui viennent d'un service relié (une base, par exemple) portent la mention **reçue d'un service relié**. Vous ne les modifiez pas ici, mais vous pouvez les renommer. Voir [Relier des services](https://docs.fransys.cloud/projets/relier-des-services/). ## Variables lues au build Les variables lues pendant la construction de l'image (par exemple `VITE_…`) ne sont pas encore transmises par la CI de Fransys. Gardez-les dans votre code, ou lisez-les au démarrage de l'application. --- # Domaine et HTTPS > L'adresse fournie par Fransys, votre propre domaine, l'enregistrement DNS à créer et le certificat HTTPS. Source : https://docs.fransys.cloud/projets/domaine-et-https/ Vérifié sur la console le 2026-10-23. ## L'adresse fournie par Fransys Chaque application publique reçoit une adresse en `fransysapp.com`, en HTTPS, dès son premier déploiement. Elle apparaît dans les réglages du service et sur sa carte du schéma. ## Ajouter votre domaine Dans le panneau du service, rubrique des domaines, saisissez le nom complet, par exemple `app.votre-domaine.fr`, sans `https://` ni chemin. Le domaine s'applique au prochain déploiement. ## Créer l'enregistrement DNS Une fois le domaine ajouté, la console affiche l'enregistrement à créer chez votre registraire : **Type**, **Nom**, **Valeur** et **TTL**, chacun copiable. - Selon le registraire, le nom s'écrit en entier ou seulement la partie avant votre domaine (par exemple `app`). - Si des enregistrements A ou AAAA existent déjà pour ce nom, supprimez-les. - La prise en compte peut prendre jusqu'à quelques heures. ## Le certificat HTTPS Il suit tout seul, une fois le DNS pris en compte. Vous n'avez rien à demander ni à renouveler. ## Rediriger un domaine **Ajouter une redirection** envoie un domaine vers un autre (par exemple `votre-domaine.fr` vers `www.votre-domaine.fr`). Le domaine d'origine doit pointer vers ce service, avec le même type d'enregistrement qu'un domaine à vous. --- # Déployer et suivre > Ce qui part au déploiement, ce qui le bloque, le retour arrière automatique, et l'historique des versions. Source : https://docs.fransys.cloud/projets/deployer-et-suivre/ Vérifié sur la console le 2026-10-23. ## Ce qui part au déploiement Chaque réglage que vous changez est enregistré, mais pas encore appliqué. La barre **Changements à déployer** du projet compte ce qui attend, service par service. **Voir le détail** liste chaque changement (« Régler … à … », variable ajoutée, domaine ajouté…). Les changements faits par un plan rejoignent la même liste. Dans **Plans**, la section **À déployer** les regroupe par projet. ## Déployer Cliquez sur **Déployer**, vérifiez le nombre de changements et le cluster, puis confirmez. Le moteur applique les changements un par un. Seul ce qui a changé est relancé. Les services créés commencent à consommer dès qu'ils tournent, dans la limite du plafond du cluster. ## Ce qui bloque un déploiement - **Le projet n'est rattaché à aucun cluster** : rattachez-le d'abord. - **Des points à corriger** : un réglage obligatoire vide, deux variables reçues du même nom… Chaque point est signalé dans son service, avec **Corriger**. - **Des avertissements** : vous pouvez **Déployer malgré les avertissements**. ## Le retour arrière automatique Si un contrôle échoue pendant le déploiement, Fransys annule les changements : votre dernière version reste en ligne. La console affiche **Retour arrière en cours**, puis **Déploiement en échec : retour arrière fait**. Ouvrez le service en difficulté : ses contrôles de santé et les dernières lignes de son journal disent pourquoi il n'a pas démarré. Corrigez, puis redéployez. ## Annuler des changements avant de déployer **Annuler les changements** remet chaque réglage à sa valeur d'avant, puis Fransys recalcule. Rien n'est déployé. Certains changements ne peuvent pas être remis automatiquement : la console les liste à part, à remettre à la main. ## L'historique des déploiements L'onglet **Déploiements** du projet liste les versions, de la plus récente à la plus ancienne : **Version N**, son état, sa durée et ses opérations. | État | Ce que ça veut dire | |---|---| | En cours | Le moteur applique les changements. | | Réussi | Tout est en ligne. | | Incident | Une opération a rencontré un problème : ouvrez la version pour voir laquelle. | | Échec | Une opération a échoué ; retour arrière automatique. | Pour défaire un plan exécuté ou revenir à une version de votre code, voir [Revenir en arrière](https://docs.fransys.cloud/projets/revenir-en-arriere/). --- # Tâches planifiées > Lancer une commande à heure fixe (export, nettoyage, envoi d'e-mails) : la fréquence et l'expression cron. Source : https://docs.fransys.cloud/projets/taches-planifiees/ Vérifié sur la console le 2026-10-23. ## Ajouter une tâche Dans le panneau d'une application, onglet **Tâches planifiées**, cliquez sur **Ajouter une tâche planifiée** : - **Commande** : ce qui sera lancé, dans le conteneur du service (par exemple `php artisan reports:send` ou `node scripts/nettoyage.js`) ; - **Planification** : quand ; - **Activée** : décochez pour suspendre la tâche sans la supprimer. La tâche s'applique au prochain déploiement du projet. ## Choisir la fréquence - **Chaque jour**, avec l'**Heure d'exécution** ; - **Chaque semaine**, avec le **Jour de la semaine** et l'heure ; - **Chaque mois**, avec le **Jour du mois** et l'heure ; - **Personnalisée** : une expression cron. La console traduit toujours la planification en phrase, par exemple « Cette tâche s'exécutera chaque lundi à 03:00 ». Relisez-la avant d'enregistrer. ## L'expression cron Cinq champs séparés par des espaces, dans l'ordre : **Minute**, **Heure**, **Jour du mois**, **Mois**, **Jour de la semaine** (0 ou 7 = dimanche). | Expression | Ce que dit la console | |---|---| | `0 3 * * *` | chaque jour à 03:00 | | `*/15 * * * *` | toutes les 15 minutes | | `30 8 * * 1-5` | à 08:30, du lundi au vendredi | | `0 0 1 * *` | le 1er de chaque mois à 00:00 | Un jour du mois au-delà du 28 saute les mois trop courts : la console le signale. ## Avec votre agent Votre agent sait ajouter une tâche planifiée dans un plan. Demandez-lui par exemple : « Ajoute une tâche qui lance `php artisan backup:clean` chaque nuit à 2 h et prépare le plan. » --- # Autres services > Les services qui ne sont ni une application ni une base de données, comme le WebSocket ou le gestionnaire de secrets. Source : https://docs.fransys.cloud/projets/autres-services/ Vérifié sur la console le 2026-10-23. ## Où les trouver Dans le projet, cliquez sur **Ajouter un service**, puis **Autres types de services**. La liste dépend de votre compte : la console n'affiche que les types disponibles pour vous. Sur le schéma, ces services sont rangés dans les colonnes **Temps réel** et **Données et secrets**. ## WebSocket Un serveur WebSocket (Soketi), compatible avec le protocole Pusher, pour les notifications en direct, le chat ou les tableaux de bord qui se mettent à jour seuls. Ajoutez-le, puis reliez-le à votre application : elle reçoit les variables de connexion (hôte, identifiant, clé et secret de l'application). Une application Laravel peut alors diffuser ses évènements avec le pilote Pusher, vers votre propre serveur. ## Gestionnaire de secrets Un coffre à secrets, à relier aux services qui en ont besoin. Pour des secrets simples (une clé d'API, un mot de passe), une variable protégée suffit : voir [Variables et secrets](https://docs.fransys.cloud/projets/variables-et-secrets/). ## Service autonome Un service qui tourne seul, sans être relié à votre code. Il se règle comme une application, dans son panneau. ## Une image qui n'est pas dans la liste Tout ce qui tourne dans un conteneur Docker s'ajoute comme une [Application](https://docs.fransys.cloud/projets/application/) : n8n, Metabase, Ollama, un outil interne… Indiquez son image et son port. --- # Revenir en arrière > Le retour arrière automatique d'un déploiement raté, revenir sur un plan exécuté, et annuler des changements avant de déployer. Source : https://docs.fransys.cloud/projets/revenir-en-arriere/ Vérifié sur la console le 2026-10-23. ## Un déploiement échoue : rien à faire Si un contrôle échoue pendant un déploiement, Fransys annule les changements tout seul : votre dernière version reste en ligne. La console affiche **Déploiement en échec : retour arrière fait, votre dernière version reste en ligne**. Corrigez, puis redéployez. ## Défaire un plan exécuté Sur la page d'un plan exécuté, **Revenir sur ce plan** prépare un nouveau plan, inverse : - la fenêtre liste **Ce qui sera défait** et **Ce qui ne peut pas être défait** (un service supprimé, par exemple) ; - les réglages reprennent la valeur qu'ils avaient avant ce plan, même s'ils ont été changés depuis ; - rien ne s'exécute tout de suite : vous relisez le plan de retour, puis l'exécutez comme les autres. Vos modifications faites dans la console sont aussi notées dans des plans : vous pouvez revenir sur elles de la même façon. ## Annuler avant de déployer Tant que des changements ne sont pas déployés, **Annuler les changements** remet chaque réglage à sa valeur d'avant. Rien n'est déployé. Voir [Déployer et suivre](https://docs.fransys.cloud/projets/deployer-et-suivre/#annuler-des-changements-avant-de-déployer). ## Revenir à une version de votre code Avec un dépôt Git, le plus sûr est de revenir en arrière dans le dépôt (un `git revert`, puis un push) : la CI construit et déploie la version corrigée. Revenir à une version précédente d'un projet en un clic, depuis l'historique des déploiements, n'existe pas encore. ## Retrouver des données Les données d'une base ne reviennent pas avec un retour arrière. Pour repartir d'une sauvegarde, voir [Sauvegardes et restauration](https://docs.fransys.cloud/exploiter/sauvegardes/). --- # Créer un cluster > Choisir la criticité, l'hébergeur, la région, le compte et les machines, puis lancer le cluster. Le modifier, le mettre hors ligne ou le supprimer ensuite. Source : https://docs.fransys.cloud/clusters/creer-un-cluster/ Vérifié sur la console le 2026-10-23. ## Ce qu'est un cluster Un cluster est un ensemble de machines chez l'hébergeur de votre choix. Fransys les réserve, installe Kubernetes et l'opère pour vous. Vos projets s'y déploient ; plusieurs projets peuvent partager un cluster. ## Créer un cluster Dans **Clusters**, cliquez sur **Nouveau cluster**. La console pose ses questions dans l'ordre : 1. **Quelle criticité ?** Basique, Stable ou Critique. Voir [Criticité](https://docs.fransys.cloud/clusters/criticite/). 2. **Où héberger le cluster ?** - **Besoin de GPU (IA, calcul) ?** Si oui, seules les régions qui proposent des machines à GPU restent. - **Où peuvent aller vos données ?** **Union européenne** ou **Partout**. - **Hébergeur**, puis la région. Chaque région affiche le prix de sa machine la moins chère, par mois. 3. **Avec quel compte ?** Le compte Fransys (machines facturées par Fransys, sur votre solde) ou votre propre compte chez l'hébergeur. Cette question n'apparaît que si vous avez un compte à vous chez cet hébergeur. Voir [Votre compte cloud](https://docs.fransys.cloud/clusters/compte-cloud/). 4. **Combien de machines ?** et **Comment gérer les machines ?** : une seule machine ou plusieurs, AutoPilot ou machines fixes. Voir [AutoPilot et plafond](https://docs.fransys.cloud/clusters/autopilot-et-plafond/). 5. **Nom du cluster**, puis **Créer et déployer**. Le détail du prix se met à jour à chaque choix, par mois, par jour ou par heure (un mois compte 730 heures, comme la facturation). ## Pendant la création Fransys commande les machines chez l'hébergeur, puis installe Kubernetes, le réseau et les certificats HTTPS : jusqu'à 15 minutes. La page se met à jour seule. Juste après, le cluster peut rester quelques minutes **Dégradé**, le temps que les dernières machines et les composants système démarrent. Il passe **En ligne** tout seul. Vous pouvez déjà déployer. > **La facturation commence dès que les machines tournent** > Le cluster consomme dès que ses machines sont créées, même sans projet dessus. ## Lire la page d'un cluster - **Ce que vous payez** : le coût par mois d'après ce qui tourne, et le coût du mois jour par jour. - **Consommation** : projet par projet, sur tout le cluster, et la capacité payée mais libre. - **Machines** : chaque machine (nœud de contrôle, machine de travail, répartiteur de charge), son état et son prix. - **Projets hébergés**, et **Rattacher un projet**. - **Configuration** : criticité, pilotage, plafond, compte, région. ## Ensuite - [Modifier, mettre hors ligne ou supprimer](https://docs.fransys.cloud/clusters/modifier-ou-supprimer/) le cluster. - [Rattacher un projet](https://docs.fransys.cloud/projets/projets/#rattacher-le-projet-à-un-cluster). - Faire tourner le cluster sur [votre compte cloud](https://docs.fransys.cloud/clusters/compte-cloud/). --- # Criticité > Basique, Stable ou Critique. Ce que chaque criticité installe au minimum, et laquelle choisir. Source : https://docs.fransys.cloud/clusters/criticite/ Vérifié sur la console le 2026-10-23. ## À quoi sert la criticité Elle fixe le minimum que Fransys installe pour faire tenir le cluster : nœuds de contrôle, répartiteur, machines de travail. Au-dessus de ce minimum, l'AutoPilot ou vos propres choix ajoutent des machines selon votre budget. ## Les trois criticités | Criticité | Pour quoi | Au minimum | |---|---|---| | **Basique** | Développement, POC, démos. Une coupure de temps en temps n'est pas grave. | Une seule machine possible | | **Stable** | Préprod, outils internes, petite production. | 1 nœud de contrôle, 1 répartiteur, 1 machine de travail | | **Critique** | Production : disponibilité maximale, même si ça coûte plus. | 3 nœuds de contrôle, 1 répartiteur, 3 machines de travail | Chaque carte de criticité affiche son prix de départ, par mois. ## Basique : une machine ou plusieurs - **Une seule machine** : tout tourne dessus, sans nœud de contrôle à part ni répartiteur. Pas d'AutoPilot. Le moins cher, pour tester. - **Plusieurs machines** : Fransys ajoute un nœud de contrôle et un répartiteur pour faire tenir l'ensemble. L'AutoPilot devient possible, sur le socle Stable. ## La machine conseillée Pour chaque criticité, la console propose une machine : - **Basique** : la moins chère, suffisante pour tester ; - **Stable** : un cran au-dessus, pour une préprod proche de la production ; - **Critique** : processeurs dédiés, pour la production. Vous pouvez en choisir une autre ; **Reprendre la machine conseillée** revient à la proposition. ## Les exigences de l'hébergeur Certains hébergeurs imposent un minimum de machines pour une configuration. La console l'affiche, par exemple « Hetzner demande au moins 2 machines pour cette configuration ». ## Changer de criticité Dans **Modifier la configuration** du cluster. Changer de criticité peut ajouter ou retirer des nœuds de contrôle : le détail du prix en tient compte avant que vous validiez. --- # AutoPilot et plafond > Laisser Fransys choisir et ajouter les machines sous un budget maximum, fixer vos propres groupes, ou garder un nombre fixe de machines. Source : https://docs.fransys.cloud/clusters/autopilot-et-plafond/ Vérifié sur la console le 2026-10-23. ## Trois façons de gérer les machines - **AutoPilot, selon un budget** : Fransys choisit les machines et en ajoute selon la charge, sans jamais dépasser votre plafond. - **AutoPilot, avec mes machines** : vous choisissez le type de machine ; l'AutoPilot reste entre le minimum et le maximum de chaque groupe, selon la charge. - **Choisir moi-même** : un nombre fixe de machines, sans ajustement automatique. L'AutoPilot est possible à toute criticité, mais jamais avec une seule machine : réglez le minimum sur 2 machines ou plus, ou passez en manuel pour un simple test. ## Le budget maximum Ce n'est pas une dépense visée : c'est le plafond que le cluster ne doit jamais dépasser, par mois. Arrivé là, l'AutoPilot n'ajoute plus de machine et vous prévient par e-mail. - L'AutoPilot demande un minimum pour tourner. La console l'affiche sous le curseur, avec un montant conseillé. En dessous, le cluster ne peut pas démarrer. - Le plafond couvre les serveurs et la part Fransys. Les volumes, sauvegardes et adresses IP que vos services ajoutent viennent en plus. ## Groupes de machines En **AutoPilot, avec mes machines** ou en **Choisir moi-même**, vous composez des groupes : un type de machine (une typologie) et un nombre, ou un minimum et un maximum. Les typologies sont rangées en **Processeurs partagés**, **Processeurs dédiés** et **Avec GPU**. Chacune affiche ses processeurs, sa mémoire et son prix par mois. Une typologie grisée n'est pas proposée dans la région. ## Quand le coût dépasse le plafond La page du cluster le signale (« plafond AutoPilot dépassé »), ainsi que la page du projet, avec **Revoir le plafond**. Relevez le budget ou réduisez ce qui tourne. ## Changer le pilotage Dans **Modifier la configuration** du cluster. Le récapitulatif compare le prix prévu aujourd'hui et le prix après le changement. Le changement est noté dans un plan à votre nom avant d'être appliqué. --- # Votre compte cloud > Faire tourner un cluster sur votre propre compte chez l'hébergeur : quand c'est utile, les clés à fournir, et ce que ça change à la facture. Source : https://docs.fransys.cloud/clusters/compte-cloud/ Vérifié sur la console le 2026-10-23. ## Pourquoi utiliser votre compte Par défaut, vos clusters tournent sur les comptes de Fransys : les machines sont facturées par Fransys, sur vos crédits. Avec votre propre compte : - les machines tournent sur votre compte chez l'hébergeur, et c'est lui qui vous les facture ; - vous accédez aux régions qui l'exigent. À la création d'un cluster, la console les signale par « nécessite votre propre compte ». Fransys installe et opère Kubernetes de la même façon. ## Ajouter un compte Dans **Clusters**, rubrique **Vos comptes cloud**, cliquez sur **Ajouter un compte**. Choisissez l'hébergeur, donnez un nom au compte (par exemple `production-hetzner`), puis la clé : | Hébergeur | Ce qu'il faut | Où la créer | |---|---|---| | Hetzner | Un jeton d'API, en lecture et écriture | Hetzner Cloud › votre projet › Sécurité › Jetons d'API | | Scaleway | Une clé d'accès, une clé secrète et l'identifiant du projet | Console Scaleway › IAM › Clés d'API ; l'identifiant dans les paramètres du projet | | Outscale | Une clé d'accès et sa clé secrète | Cockpit Outscale › Access Keys | Cliquez sur **Vérifier et ajouter**. Fransys vérifie la clé auprès de l'hébergeur avant de l'enregistrer. Elle n'est plus jamais affichée ensuite. ## Choisir le compte d'un cluster À la création d'un cluster, l'étape **Avec quel compte ?** apparaît dès que vous avez un compte chez l'hébergeur choisi : **Compte Fransys** ou **Votre compte**. Vous pouvez aussi **Connecter un autre compte** sans quitter la création. Pour changer le compte d'un cluster existant, passez par **Modifier la configuration**. Le cluster se redéploie ensuite avec cette configuration. ## Changer la clé **Modifier** le compte, puis **Remplacer la clé**. Laissez vide pour garder la clé actuelle. Fransys vérifie la nouvelle clé avant de l'enregistrer ; révoquez l'ancienne chez l'hébergeur une fois le changement fait. ## Supprimer le compte Un compte utilisé par un cluster ne peut pas être supprimé : supprimez ou déplacez d'abord le cluster. Fransys oublie alors les clés ; rien n'est supprimé chez l'hébergeur. Pensez à y révoquer la clé. --- # Montée en charge > Tenir un pic de trafic : plus de répliques pour un service, plus de machines pour le cluster, et ce que ça coûte. Source : https://docs.fransys.cloud/clusters/montee-en-charge/ Vérifié sur la console le 2026-10-23. ## Deux niveaux - **Le service** : plus de répliques de votre application, sur les machines qui existent. - **Le cluster** : plus de machines, pour faire de la place aux répliques. Les deux se combinent : quand les répliques ne tiennent plus sur les machines, l'AutoPilot en ajoute. ## Plus de répliques pour un service Dans le panneau de l'application, onglet **Ressources**, **Nombre de répliques** : - **Fixe** : le nombre de **Répliques** que vous choisissez ; - **Automatique** : Fransys ajoute ou retire des répliques selon la charge. Chaque réplique réserve le processeur et la mémoire réglés dans **Réservations**. Ce sont ces réservations qui remplissent les machines. ## Plus de machines pour le cluster - **AutoPilot, selon un budget** : Fransys choisit les machines et en ajoute selon la charge, jusqu'à votre plafond. - **AutoPilot, avec mes machines** : il reste entre le minimum et le maximum de chaque groupe. - **Choisir moi-même** : le nombre de machines ne bouge pas ; changez-le dans **Modifier la configuration**. Voir [AutoPilot et plafond](https://docs.fransys.cloud/clusters/autopilot-et-plafond/). ## Ce que ça coûte Une machine ajoutée est facturée tant qu'elle tourne, à l'heure. Avec l'AutoPilot selon un budget, le total ne dépasse jamais le plafond : arrivé là, aucune machine n'est ajoutée, et vous êtes prévenu par e-mail. La page du cluster montre la **Capacité libre**, payée mais inutilisée, et la consommation projet par projet. Si elle reste haute longtemps, réduisez les machines ou les réservations. ## Avant un pic attendu Un lancement, une campagne : passez à quelques répliques en mode fixe, et vérifiez que le plafond laisse de la marge. Votre agent peut le préparer dans un plan : « Prépare le projet shop pour un pic de trafic demain, sans dépasser 300 € par mois. » --- # GPU > Des machines à GPU pour l'IA, l'inférence ou le calcul. Où les trouver, comment les choisir, et les faire utiliser par un service. Source : https://docs.fransys.cloud/clusters/gpu/ Vérifié sur la console le 2026-10-23. ## Où trouver des GPU Seuls certains hébergeurs et certaines régions en proposent, et leur stock change souvent. À la création d'un cluster, répondez **Oui** à **Besoin de GPU (IA, calcul) ?** : seules les régions qui proposent des machines à GPU restent, avec le prix de la machine GPU la moins chère. Si aucune région n'apparaît, aucune machine à GPU n'est disponible en ce moment chez ces hébergeurs. Réessayez plus tard, essayez **Partout** pour la zone des données, ou répondez **Non**. ## Choisir la machine À l'étape **Combien de machines ?**, choisissez la machine à GPU dans un groupe de machines. Les typologies à GPU sont rangées sous **Avec GPU**, avec leurs processeurs, leur mémoire et leur prix par mois. ## Faire utiliser le GPU par un service Dans le panneau de l'application, onglet **Ressources**, réglez **GPU** sur **NVIDIA**. Le service sera placé sur une machine à GPU du cluster. Pour servir un modèle d'IA, une image comme Ollama ou vLLM s'ajoute comme une [Application](https://docs.fransys.cloud/projets/application/). ## Ce que ça coûte La machine au prix de l'hébergeur, plus 100 € par GPU et par mois pour Fransys. Voir la [grille tarifaire](https://docs.fransys.cloud/budget/grille-tarifaire/). Une machine à GPU coûte cher : mettez le cluster hors ligne quand vous ne vous en servez pas. --- # Modifier, mettre hors ligne, supprimer > Changer la configuration d'un cluster, l'arrêter pour ne plus payer ses machines, le remettre en ligne ou le supprimer. Source : https://docs.fransys.cloud/clusters/modifier-ou-supprimer/ Vérifié sur la console le 2026-10-23. ## Modifier la configuration Sur la page du cluster, **Modifier la configuration** permet de changer la criticité, le pilotage (AutoPilot ou machines fixes), les machines et le compte. - L'hébergeur et la région ne changent pas. Pour déménager, créez un autre cluster et rattachez-y vos projets. - Le récapitulatif compare le prix prévu aujourd'hui et le prix après le changement. - On ne modifie pas un cluster pendant qu'il se déploie ou s'arrête : attendez la fin. **Appliquer les changements** note le changement dans un plan à votre nom, le valide et l'exécute aussitôt : le journal garde qui a changé quoi. Le cluster se redéploie ensuite avec cette configuration ; le suivi s'affiche sur sa page. Pour qu'une autre personne valide d'abord, choisissez **Préparer pour relecture** : le plan attend dans **Plans**. ## Mettre hors ligne Dans le menu du cluster, choisissez la mise hors ligne. - Les machines sont libérées une à une et ne coûtent plus rien. - Tous les projets du cluster passent hors ligne. - Les adresses IP et volumes gardés restent facturés ; la page du cluster affiche le montant. - La configuration est gardée. > **Les bases perdent leurs données** > À la mise hors ligne, les bases des projets hébergés perdent leurs données. Réglez d'abord leur **Restaurer depuis** sur **Ce service lui-même** : voir [Sauvegardes et restauration](https://docs.fransys.cloud/exploiter/sauvegardes/#avant-de-mettre-hors-ligne). ## Remettre en ligne **Remettre en ligne** relance le cluster avec sa configuration. La console affiche le coût estimé par mois ; la facturation reprend dès que les machines tournent. - Les projets hébergés restent hors ligne : déployez-les ensuite. - Une base repart de sa dernière sauvegarde seulement si sa source de restauration est réglée sur elle-même ; sinon, elle repart vide. - Si la configuration ne suit plus les règles actuelles (un budget sous le minimum, par exemple), la console demande de la modifier avant. ## Supprimer Seulement hors ligne : mettez d'abord le cluster hors ligne. Le cluster et sa configuration sont supprimés, c'est définitif. ## Renommer **Renommer le cluster** : 30 caractères au plus. Seul le nom change. --- # Brancher un agent > Brancher Claude Code, Cursor ou Claude Desktop sur Fransys par le MCP, avec une clé d'agent en lecture seule. Source : https://docs.fransys.cloud/agents/brancher-un-agent/ Vérifié sur la console le 2026-10-23. ## Ce que votre agent pourra faire Branché sur Fransys, votre agent lit vos projets, services, réglages, clusters, journaux et mesures, et prépare des plans. Chaque plan attend qu'une personne de l'équipe le valide dans **Plans** : l'agent n'exécute rien lui-même. Voir [Ce qu'un agent peut faire](https://docs.fransys.cloud/agents/ce-qu-un-agent-peut-faire/). ## Les étapes Tout se passe dans la page **Brancher** de la console. 1. **Vérifier le serveur MCP** En haut de la page, **Le serveur MCP répond.** confirme que tout est prêt, avec le nombre d'outils disponibles et l'adresse du serveur. 2. **Créer une clé d'agent** Donnez-lui un nom (par exemple « Claude Code – Kevin ») et choisissez ce qu'elle permet de lire. Cochez **Lire aussi la facturation** si l'agent doit voir vos coûts. Cliquez sur **Créer la clé**. Le secret ne s'affiche qu'une fois : copiez-le maintenant. Il est aussi déjà dans les commandes de l'étape suivante. La clé devient active 10 à 15 secondes après sa création. 3. **Ajouter Fransys à votre agent** Copiez la commande ou la configuration de votre outil depuis la page : l'adresse du serveur et votre clé y sont déjà. **Claude Code** Dans votre terminal, à la racine du projet : ```sh claude mcp add --transport http fransys --header "Authorization: Bearer " ``` Vérifiez ensuite avec `claude mcp list` : « fransys » doit apparaître comme connecté. **Cursor** Dans `.cursor/mcp.json` à la racine du projet, ou dans `~/.cursor/mcp.json` pour tous vos projets : ```json { "mcpServers": { "fransys": { "url": "", "headers": { "Authorization": "Bearer " } } } } ``` Rouvrez les réglages MCP de Cursor : « fransys » doit afficher ses outils. **Claude Desktop** Dans Claude Desktop, ouvrez **Réglages › Développeur › Modifier la configuration**, puis ajoutez le serveur dans `claude_desktop_config.json` : ```json { "mcpServers": { "fransys": { "command": "npx", "args": ["-y", "mcp-remote", "", "--header", "Authorization:${AUTH_HEADER}"], "env": { "AUTH_HEADER": "Bearer " } } } } ``` Redémarrez Claude Desktop. Le pont `mcp-remote` est lancé par `npx` : il faut Node.js sur la machine. Puis cliquez sur **J'ai copié, masquer le secret**. 4. **Essayer** Demandez-lui par exemple : - « Fais le tour de mes projets et dis-moi quels services sont désactivés. » - « Lis les logs de mon API de la dernière heure et explique-moi les erreurs. » - « Ajoute un Redis à mon projet et prépare le plan. » Quand l'agent prépare un plan, il arrive dans **Plans**, à valider ou refuser. ## Une clé par agent Créez une clé par agent ou par personne. La page liste les clés de l'organisation : qui l'a créée, quand elle a servi pour la dernière fois. Le journal dit quelle clé a fait quoi. **Retirer la clé** coupe l'accès de l'agent tout de suite. Les plans qu'il a préparés restent dans **Plans**. Ne partagez pas une clé : elle donne accès à vos données en lecture. Si vous avez perdu un secret, créez une nouvelle clé et retirez l'ancienne. ## Ce que les agents ont fait En bas de la page **Brancher**, **Derniers gestes des agents** liste les plans préparés, modifiés ou annulés et les outils utilisés. **Tout le journal** ouvre la page **Journal**. --- # Les plans > Un plan liste les actions qu'un agent ou vous-même voulez faire. Le relire, le valider ou le refuser, le reprendre après un échec, revenir dessus. Source : https://docs.fransys.cloud/agents/plans/ Vérifié sur la console le 2026-10-23. ## Ce qu'est un plan Une liste d'actions sur vos projets et vos clusters (créer un service, régler une variable, déployer…), avec ce que chacune fera. Rien ne s'exécute avant qu'une personne de l'équipe le valide. Un plan vient : - **d'un agent**, par le MCP : il arrive dans **À décider** ; - **de la console** : vos modifications sont notées dans un plan à votre nom (« Modifications depuis l'interface »), terminé par le prochain déploiement ; - **d'un import** : **Importer un plan** accepte un plan au format JSON, présenté pour relecture. ## La page Plans Une section par état : **En cours**, **En échec**, **À décider**, **À déployer**, puis l'**Historique**. Filtrez par projet avec **Filtrer par projet**. | Statut | Ce que ça veut dire | |---|---| | Brouillon | En préparation, pas encore soumis. | | À décider | Attend votre décision. | | Validé | Validé, pas encore lancé. | | En cours | Les actions s'exécutent. | | Exécuté | Toutes les actions sont faites. | | En échec | Une action a échoué ; le plan s'est arrêté. | | Refusé | Refusé, avec la raison donnée. | | Annulé | Annulé par son auteur, ou abandonné. | | À déployer | Modifications enregistrées, en attente du déploiement du projet. | ## Relire un plan Cliquez sur **Relire**. La page du plan dit qui l'a préparé et liste ses actions, exécutées dans l'ordre avec vos droits. Elle signale : - les actions qui ont un **effet direct** : déploiement, suppression ou machines ; - les autres changements déjà en attente sur le projet, qui partiront avec le déploiement. Les valeurs secrètes sont masquées. **Voir le JSON du plan** montre le plan tel qu'il est enregistré. ## Valider ou refuser - **Valider et exécuter** : les actions sont exécutées dans l'ordre par Fransys. Vous pouvez fermer la page, l'exécution continue. - **Refuser** : indiquez pourquoi ; l'auteur, agent ou personne, le verra. - **Annuler le plan** : pour un plan que vous avez préparé vous-même. ## Quand un plan s'arrête Si Fransys refuse une action, le plan s'arrête. **Ce que Fransys a répondu** détaille les appels de l'action en échec. Les actions déjà faites sont gardées. - **Reprendre** : la reprise repart de l'action qui a échoué. Ce qui a déjà été créé est retrouvé, rien n'est recréé. - **Abandonner** : le plan passe dans l'historique comme annulé. Les actions déjà faites restent en place. ## Revenir sur un plan Sur un plan exécuté, **Revenir sur ce plan** prépare un nouveau plan, inverse, que vous relisez puis exécutez comme les autres. La fenêtre liste ce qui sera défait et ce qui ne peut pas l'être (un service supprimé, par exemple). Les réglages reprennent la valeur qu'ils avaient avant ce plan, même s'ils ont été changés depuis. ## Le journal Chaque plan laisse une trace dans **Journal** : qui l'a préparé, soumis, validé ou refusé, et le résultat de chaque action. Filtrez par **Personnes** ou **Agents**. --- # Ce qu'un agent peut faire > Ce que votre agent peut lire, ce qu'il peut préparer, et ce qu'il ne peut jamais faire sur Fransys. Source : https://docs.fransys.cloud/agents/ce-qu-un-agent-peut-faire/ Vérifié sur la console le 2026-10-23. ## Lire Vos projets, services, réglages, clusters, journaux et mesures, selon les droits de sa clé. La facturation seulement si la clé le permet (**Lire aussi la facturation**). Les secrets restent masqués. ## Préparer des plans L'agent dépose des plans, qui arrivent dans **Plans**, en attente de votre décision. Il peut modifier ou annuler un plan qu'il a préparé tant qu'il n'est pas validé, et proposer de revenir sur un plan exécuté. ## Jamais : valider ou exécuter Le MCP n'a aucun outil pour valider ou exécuter un plan. Une personne de l'équipe valide chaque plan dans la console, qui l'exécute ensuite. C'est le sas : l'agent prépare, un humain décide. ## Ce que l'agent ne fait pas non plus - Il ne modifie pas votre dépôt Git. S'il faut changer quelque chose (un port, une variable lue par votre point d'entrée), il vous dit quoi changer. - Il ne calcule pas un prix lui-même : il passe par l'estimation de Fransys. ## Les droits d'une clé Une clé d'agent ne donne que des droits de lecture : projets, services, journaux, clusters, comptes cloud, et la facturation si vous l'avez cochée. Retirez une clé pour couper l'accès d'un agent tout de suite. Voir [Brancher un agent](https://docs.fransys.cloud/agents/brancher-un-agent/). ## Bientôt : équipe et règles de validation La page **Accès** réunira les agents branchés, les personnes de votre équipe et leur rôle, et des règles de validation, par exemple une deuxième personne pour exécuter le plan d'un agent. En attendant, vos agents se branchent depuis **Brancher**. --- # Bien formuler une demande > Des demandes à votre agent qui donnent un bon plan du premier coup, par situation. Source : https://docs.fransys.cloud/agents/bien-formuler-une-demande/ Vérifié sur la console le 2026-10-23. ## Ce qui fait un bon plan Dites à l'agent : - **quel projet** et **quel service** (leur nom suffit, l'agent retrouve les ids) ; - **ce que vous voulez obtenir**, pas comment le faire ; - **vos limites** : un budget, « sans redéployer », « ne touche pas à la base » ; - **de préparer un plan** : il n'exécute rien de toute façon, mais il saura qu'il doit déposer un plan à relire. ## Lire et comprendre - « Fais le tour de mes projets et dis-moi quels services sont désactivés. » - « Lis les logs de mon API de la dernière heure et explique-moi les erreurs. » - « Pourquoi le service worker du projet shop redémarre-t-il ? Regarde sa santé et son journal. » - « Combien me coûte le cluster prod par mois, et qu'est-ce qui pèse le plus ? » ## Changer quelque chose - « Ajoute un Redis au projet shop, relie-le à l'API, et prépare le plan. » - « Ajoute la variable `MAIL_FROM=contact@exemple.fr` au service api et prépare le déploiement. » - « Passe le service api à 3 répliques fixes et prépare le plan. » - « Ajoute une tâche qui lance `php artisan backup:clean` chaque nuit à 2 h. » ## Lancer une application depuis son dépôt Ouvrez l'agent dans le dossier du dépôt et utilisez la consigne que propose la console (**Copier la consigne**, dans le guide de lancement du service). L'agent lit le Dockerfile, le docker-compose et le `.env.example`, puis prépare : le port, les variables, les bases à ajouter et à relier, les tâches planifiées. Voir [Déployer votre code](https://docs.fransys.cloud/demarrer/deployer-votre-code/). ## Chiffrer avant de construire - « Combien coûterait ce projet sur Fransys : une API Node, un front, PostgreSQL, en Stable chez Scaleway ? » L'agent passe par l'estimation de Fransys, avec le catalogue du jour : il ne calcule pas un prix lui-même. ## Défaire - « Reviens sur le dernier plan exécuté du projet shop. » L'agent prépare un plan de retour, que vous relisez. Voir [Revenir en arrière](https://docs.fransys.cloud/projets/revenir-en-arriere/). ## Après la demande Le plan arrive dans **Plans**, **À décider**. Relisez les actions, en particulier celles à **effet direct** (déploiement, suppression, machines), puis **Valider et exécuter** ou **Refuser** en disant pourquoi : l'agent verra la raison. Voir [Les plans](https://docs.fransys.cloud/agents/plans/). --- # Équipe et droits > Bientôt : décider qui peut faire quoi dans votre organisation, personnes et agents, et des règles de validation des plans. Source : https://docs.fransys.cloud/agents/equipe-et-droits/ Vérifié sur la console le 2026-10-23. Fonction pas encore disponible : cette page décrit ce qui arrive. ## Ce qui arrive La page **Accès** réunira : - **Agents branchés** : les agents branchés par le MCP Fransys et leurs droits, lire seulement ou préparer des plans, sur tous les projets ou quelques-uns ; - **Équipe** : les personnes de votre organisation et leur rôle : qui voit, qui exécute un plan, qui relève un plafond, qui gère les accès ; - **Règles de validation** : les règles qui encadrent les plans, par exemple une deuxième personne pour exécuter le plan d'un agent ou pour relever un gros plafond. ## En attendant - Les agents se branchent depuis **Brancher**, chacun avec sa clé. Voir [Brancher un agent](https://docs.fransys.cloud/agents/brancher-un-agent/). - Les membres et leurs rôles se gèrent dans l'espace de connexion Fransys, depuis **Mon compte**, rubrique **Organisation**. Voir [Mon compte et organisation](https://docs.fransys.cloud/compte/mon-compte/). --- # La doc pour votre agent > Comment un agent lit cette documentation : les outils docs_search et docs_read du MCP Fransys, llms.txt, chaque page en Markdown, et l'index de recherche. Source : https://docs.fransys.cloud/agents/pour-votre-agent/ Vérifié sur la console le 2026-10-23. ## Trois façons de lire la doc Votre agent lit la même documentation que vous, sans le menu ni la mise en page : | Adresse | Ce qu'elle contient | |---|---| | `https://docs.fransys.cloud/llms.txt` | Le sommaire : une ligne par page, avec sa description et son lien en Markdown. | | `https://docs.fransys.cloud/llms-full.txt` | Toute la doc en un seul fichier. | | `https://docs.fransys.cloud/.md` | Une page en Markdown. Ajoutez `.md` à l'adresse d'une page, sans la barre finale. | Sur chaque page, **Copier pour un agent** copie sa version Markdown, et **Ouvrir dans Claude** ou **Ouvrir dans ChatGPT** ouvre une conversation qui part de la page. ## Le dire à votre agent Ajoutez une ligne aux instructions de votre projet (`CLAUDE.md`, `AGENTS.md`, règles de Cursor) : ```md Pour tout ce qui concerne Fransys, lis d'abord https://docs.fransys.cloud/llms.txt, puis la page .md qui correspond. Cite la page que tu utilises. ``` ## L'index de recherche `https://docs.fransys.cloud/search-index.json` découpe chaque page en sections (une par titre de niveau 2), avec leur texte en Markdown, leur lien et la date de vérification de la page. ## Dans le MCP Fransys Un agent branché au MCP Fransys cherche dans la doc sans rien ajouter : - `docs_search` cherche les sections qui répondent à une question ; - `docs_read` lit une page ou une section en Markdown. Il s'appuie sur l'index de recherche ci-dessus, et cite la page qu'il a lue. Pour brancher le MCP, voir [Brancher un agent](https://docs.fransys.cloud/agents/brancher-un-agent/). Un agent qui n'a pas le MCP passe par `llms.txt`. ## La date de vérification Chaque page indique quand elle a été vérifiée sur la console. Une page marquée **Bientôt** décrit une fonction qui n'est pas encore disponible. --- # La page Aujourd'hui > La page d'accueil de la console : ce qui demande votre attention, la santé de vos services, vos crédits et vos derniers déploiements. Source : https://docs.fransys.cloud/exploiter/aujourd-hui/ Vérifié sur la console le 2026-10-23. ## En une phrase La page s'ouvre sur ce qui compte maintenant : « Tout est en ordre. », « 2 points à surveiller. » ou « Le déploiement de shop est en cours. ». **Filtrer par projet** restreint toute la page à un projet. ## Les chiffres - **Santé** : les services au vert sur le total, et ceux en difficulté ; - **À déployer** : les changements qui attendent ; - **Crédits restants** : et combien de temps ils tiennent au rythme actuel ; - **Coût réel, par mois** : avec la projection à la fin de la période ; - **Machines** : prêtes sur le total, et le nombre de clusters. ## À faire La liste de ce qui demande votre attention, chaque ligne avec son bouton : - un plan **à décider**, préparé par un agent : **Relire** ; - un service **dégradé** ou **critique**, des machines indisponibles : **Voir le suivi** ; - des changements à déployer sur un projet : **Déployer** ; - des crédits bientôt épuisés, ou l'infrastructure bientôt éteinte : **Recharger** ; - un cluster qui coûte plus que son plafond : **Revoir**. « Rien à faire » : vos services tournent et rien n'attend d'être déployé. ## Le reste de la page - **Clusters** : chacun avec ses machines prêtes, son processeur et sa mémoire ; - **Crédits et dépense** : ce qui est consommé, et si vos crédits couvrent la période ; - **Projets** : chacun avec ses services et ce qui attend ; - **Derniers déploiements** : projets et clusters, en cours, réussis ou en échec. ## Pour démarrer Tant que vous n'avez pas fini, la carte **Pour démarrer** guide vos cinq premières étapes. Voir [Premier déploiement](https://docs.fransys.cloud/demarrer/premier-deploiement/#la-carte--pour-démarrer-). --- # Monitoring > Lire l'état d'un cluster et de ses services, leur consommation, leurs machines, et le détail d'un service en difficulté. Source : https://docs.fransys.cloud/exploiter/monitoring/ Vérifié sur la console le 2026-10-23. ## La page Monitoring Elle suit un cluster à la fois, avec des mesures toutes les 30 secondes. Choisissez la période des courbes : 1 heure, 6 heures, 24 heures, 7 jours ou 30 jours. **Relire** relance la lecture tout de suite. En tête : - **Services au vert** : combien de services passent leurs contrôles de santé, contrôlés chaque minute ; - **Machines** : combien sont prêtes, combien indisponibles ; - **Processeur** et **Mémoire des machines de travail** : ce qui est utilisé, et ce que vos services ont réservé. ## Vos services Le tableau donne, pour chaque service : sa santé, ses instances, ses redémarrages sur 24 heures et depuis quand il tourne. Un service qui redémarre souvent ou dont les instances ne sont pas prêtes est le premier à regarder. ## Consommation par projet Le processeur et la mémoire, projet par projet. **Fransys (système)** regroupe les outils qui font tourner le cluster. ## Machines Chaque machine : son rôle (nœud de contrôle ou machine de travail), ses cœurs, sa mémoire, depuis quand elle tourne, sa charge moyenne sur 5 minutes, et son état (**Prête** ou **Indisponible**). ## Accès publics et stockage Les domaines, les adresses du répartiteur et le stockage réservé par projet. L'occupation réelle des volumes et les mesures de trafic (requêtes, temps de réponse) ne remontent pas encore. ## Le détail d'un service Sur le schéma ou la liste d'un projet, la pastille d'état d'un service ouvre son détail : - **Contrôles de santé** : chaque contrôle, son statut et son message ; - **Dernières lignes du journal** du service. Si le dernier déploiement du service a échoué, le détail le dit, avec **Voir le déploiement**. **Journal et monitoring complets** ouvre le suivi du service. ## Avec votre agent Un agent branché lit les mêmes mesures, le journal et les contrôles de santé d'un service. Demandez-lui par exemple : « Lis les logs de mon API de la dernière heure et explique-moi les erreurs. » Voir [Brancher un agent](https://docs.fransys.cloud/agents/brancher-un-agent/). ## Bientôt Les alertes et l'historique des incidents. --- # États d'un projet, d'un cluster, d'un service > Ce que veut dire chaque état affiché par la console, et quoi faire quand il n'est pas au vert. Source : https://docs.fransys.cloud/exploiter/etats/ Vérifié sur la console le 2026-10-23. ## Cluster | État | Ce que ça veut dire | Quoi faire | |---|---|---| | En ligne | Toutes les machines sont prêtes. | Rien. | | Mise en ligne en cours | Les machines se créent, puis Kubernetes s'installe : jusqu'à 15 minutes. | Attendre ; la page se met à jour seule. | | Mise à jour en cours | Une nouvelle configuration s'applique. | Attendre. | | Dégradé | Des machines ne sont pas prêtes. Les projets tournent encore, avec moins de marge. | Normal quelques minutes après une création. Si ça dure, ouvrez **Voir le suivi** ou écrivez-nous. | | Critique | Certains projets peuvent ne plus répondre. | Ouvrez **Voir le suivi**, puis écrivez à l'équipe depuis le bouton d'aide. | | Mise hors ligne en cours | Les machines sont libérées une à une. | Attendre. | | Hors ligne | Aucune machine ne tourne. La configuration est gardée. | **Remettre en ligne** quand vous en avez besoin. | Une machine est **en création**, **en marche** ou **en arrêt**. ## Projet | État | Ce que ça veut dire | |---|---| | Hors ligne | Rien ne tourne. | | Mise en ligne en cours | Un déploiement s'applique. | | En ligne | Tous les services sont en ligne. | | Un service demande votre attention | Un service ne démarre pas, ou un contrôle de santé échoue. Ouvrez-le. | | Arrêt en cours | La mise hors ligne s'applique. | ## Service - **à configurer** : le type du service n'est pas encore choisi (plateforme, moteur…). - **à corriger** : un réglage bloque le déploiement. Cliquez sur **Corriger**. - **désactivé** : le service n'est plus déployé ; sa configuration est gardée. - **aucune instance prête** : le service ne démarre pas. Son détail montre ses contrôles de santé et son journal. - **dernier déploiement en échec** : retour arrière fait, la version précédente reste en ligne. ## Déploiement **En cours**, **Réussi**, **Incident** ou **Échec**. Voir [Déployer et suivre](https://docs.fransys.cloud/projets/deployer-et-suivre/). ## Sauvegarde **terminée**, **en cours**, **en attente**, **échouée** ou **annulée**. Voir [Sauvegardes et restauration](https://docs.fransys.cloud/exploiter/sauvegardes/). ## Plan Voir les statuts dans [Les plans](https://docs.fransys.cloud/agents/plans/#la-page-plans). --- # Sauvegardes et restauration > Les sauvegardes automatiques de PostgreSQL, MariaDB et Redis, où les voir, et comment repartir d'une sauvegarde. Source : https://docs.fransys.cloud/exploiter/sauvegardes/ Vérifié sur la console le 2026-10-23. ## Ce qui est sauvegardé Les bases PostgreSQL, MariaDB et Redis sont sauvegardées automatiquement. Dans l'onglet **Sauvegardes** de la base, réglez la **Fréquence des sauvegardes** et la **Durée de conservation (jours)**. Les applications, elles, n'ont pas de sauvegarde : gardez leurs données dans une base, ou dans un stockage externe. Le stockage des sauvegardes est facturé au Go (voir la [grille tarifaire](https://docs.fransys.cloud/budget/grille-tarifaire/)). ## Voir les sauvegardes d'une base Dans le panneau de la base, **Dernières sauvegardes** liste les plus récentes : la date, la **taille stockée** (compressée, telle que la sauvegarde est conservée), la **taille brute** (avant compression) et le statut. **Voir toutes les sauvegardes** les affiche page par page. ## Repartir d'une sauvegarde Réglez **Au premier démarrage** sur **Depuis une sauvegarde**. Le réglage **Restaurer depuis** d'une base choisit d'où elle repart : - **Ce service lui-même** : sa dernière sauvegarde est restaurée quand il redémarre (remise en ligne) ; - **une autre base du même moteur**, dans ce projet ou un autre : cherchez-la par son nom ou celui de son projet. Puis la **Sauvegarde à restaurer** : la plus récente, ou une sauvegarde précise. **Restaurer jusqu'à** fixe un point dans le temps (heure locale) ; vide, tout ce que contient la sauvegarde est restauré. > **Quand la restauration a lieu** > La sauvegarde est restaurée quand la base démarre : à sa création, ou quand elle est remise en ligne. Les données présentes sont alors remplacées. Pour récupérer des données sans toucher à la base en place, ajoutez une nouvelle base du même moteur et choisissez la base d'origine comme source. Sans source choisie, une base démarre vide. ## Avant de mettre hors ligne Mettre un projet ou un cluster hors ligne efface les données des bases. Réglez d'abord **Restaurer depuis** sur **Ce service lui-même** : à la remise en ligne, chaque base repartira de sa dernière sauvegarde. --- # Journal > Qui a fait quoi, quand : chaque modification faite dans la console et chaque plan préparé par un agent y laisse une trace. Source : https://docs.fransys.cloud/exploiter/journal/ Vérifié sur la console le 2026-10-23. ## Ce que garde le journal Chaque modification faite dans la console et chaque plan préparé par un agent : l'auteur, l'action et son résultat. Par exemple : - **Kevin** a validé le plan « Ajouter Redis » ; - **Claude Code – Kevin** a préparé le plan « Passer l'API à 3 répliques » ; - **Kevin** a créé la clé d'agent « Cursor – Léa » ; - plan « Ajouter Redis » exécuté. Les évènements sont rangés par jour, du plus récent au plus ancien. **Voir les évènements plus anciens** remonte plus loin. ## Filtrer - **Tout le monde**, **Personnes** ou **Agents** ; - un projet, ou **Tous les projets**. Chaque évènement lié à un plan ouvre ce plan (**Plan**). ## Les clés d'agent Chaque agent laisse une trace sous le nom de sa clé. Pour savoir ce qu'un agent a fait, filtrez sur **Agents** ; pour couper son accès, retirez sa clé dans **Brancher**. Voir [Brancher un agent](https://docs.fransys.cloud/agents/brancher-un-agent/#une-clé-par-agent). ## Ce que le journal ne montre pas encore Les changements faits ailleurs que dans cette console (l'ancienne interface, ou les recalculs de Fransys) n'y apparaissent pas. --- # Notifications > La cloche de la console : plans soumis, plans exécutés ou en échec, crédits bientôt épuisés. Et ce qui arrive : e-mail, Slack, heures calmes. Source : https://docs.fransys.cloud/exploiter/notifications/ Vérifié sur la console le 2026-10-23. ## La cloche En haut de la console, la cloche compte les notifications non lues : - **Un agent a soumis un plan** : il est **À décider** ; - un plan **exécuté**, **en échec**, ou une action qui a échoué dans un plan ; - un **Déploiement en échec** ; - **Quelqu'un a refusé votre plan**, avec la raison ; - un agent **propose de revenir** sur un plan ; - **Infrastructure bientôt éteinte**, ou **Crédits épuisés**, avec le lien pour recharger. Ouvrir une notification la marque comme lue, avec les plus anciennes. **Tout marquer comme lu** les vide. **Tout le journal** ouvre la page **Journal**. ## Messages récents Les messages qui s'affichent en bas de l'écran (« Déploiement lancé », « Plan exécuté »…) se relisent depuis la cloche : les 20 derniers messages de la visite, sur cet appareil. ## Bientôt Dans **Mon compte**, rubrique **Notifications** : - choisir ce qui vous est notifié, et où : par e-mail, sur Slack ou dans le navigateur ; - des **heures calmes** : la nuit, seules les alertes critiques passent ; - **Slack** : recevoir les plans et les décider depuis un canal. En attendant, l'AutoPilot vous prévient par e-mail quand un cluster atteint son plafond. --- # Alertes > Bientôt : être prévenu quand un service ou un budget dérape, avec une solution déjà préparée. Source : https://docs.fransys.cloud/exploiter/alertes/ Vérifié sur la console le 2026-10-23. Fonction pas encore disponible : cette page décrit ce qui arrive. ## Ce qui arrive - **Des alertes avec une solution prête** : quand un service est en difficulté, Fransys prépare le plan qui le corrige, chiffré, à valider. - **Des alertes de budget** à 80 % et 100 %. - **L'historique des incidents**, dans la page **Monitoring**. ## En attendant - La page **Aujourd'hui** liste ce qui demande votre attention : services dégradés ou critiques, machines indisponibles, crédits bientôt épuisés, plafond dépassé. Voir [La page Aujourd'hui](https://docs.fransys.cloud/exploiter/aujourd-hui/). - La cloche signale les déploiements et les plans en échec. Voir [Notifications](https://docs.fransys.cloud/exploiter/notifications/). - Votre agent peut faire le tour à votre place : « Regarde la santé de mes services et dis-moi ce qui ne va pas. » --- # Comment Fransys facture > Des crédits consommés à l'heure, sans abonnement. Ce que vous payez, où le voir, et vos factures. Source : https://docs.fransys.cloud/budget/comment-fransys-facture/ Vérifié sur la console le 2026-10-23. ## Des crédits, sans abonnement Vous achetez des crédits : 1 crédit = 1 €. Ils sont consommés au fil de l'eau, à l'heure, tant que des machines tournent. Rien ne tourne, rien n'est consommé. Vous rechargez quand vous voulez, ou vous activez le paiement automatique. Voir [Crédits et paiement automatique](https://docs.fransys.cloud/budget/credits-et-paiement-automatique/). ## Ce que vous payez - **Les machines au prix de l'hébergeur**, quand le cluster tourne sur le compte Fransys. Sur votre propre compte cloud, l'hébergeur vous les facture directement. - **La part Fransys** : selon les processeurs, la mémoire et les GPU des machines, plus le répartiteur de charge, les adresses IP, les volumes, les sauvegardes, les journaux et les mesures. Le détail poste par poste : [Grille tarifaire](https://docs.fransys.cloud/budget/grille-tarifaire/). Avant chaque création de cluster, la console affiche le coût par mois. Un mois de facturation compte 730 heures. ## La page Budget En tête, quatre chiffres : - **Crédits restants**, sur le solde du début de la période ; - **Consommé** depuis le début de la période ; - **Rythme actuel, par mois**, avec le montant par jour et par heure ; - **Fin de période, au rythme actuel**. Puis une phrase qui dit combien de temps vos crédits tiennent, et ce qui se passe ensuite. Voir [Ne jamais être coupé](https://docs.fransys.cloud/budget/ne-jamais-etre-coupe/). ## Où va votre argent La rubrique **Où va votre argent** détaille la dépense par cluster, puis par ressource facturée (serveurs, répartiteur, adresses IP, volumes) : depuis quand elle tourne, ce qu'elle a consommé, et son prix si elle tourne tout le mois. **Exporter en CSV** donne le même tableau. ## Factures et relevés - **Une facture à chaque recharge** de crédits. - **Un relevé de consommation** à la fin de chaque période. Ils sont dans **Factures et relevés**, en PDF. Vos **coordonnées de facturation** (nom ou raison sociale, adresse, pays, numéro de TVA) y figurent ; le pays fixe la TVA appliquée. --- # Grille tarifaire > Ce que Fransys facture en plus du prix de l'hébergeur, poste par poste. Source : https://docs.fransys.cloud/budget/grille-tarifaire/ Vérifié sur la console le 2026-10-23. ## En plus du prix de l'hébergeur Les machines sont facturées au prix public de l'hébergeur. Fransys ajoute, pour chaque machine du cluster (machines de travail et nœuds de contrôle), une part calculée sur la machine entière, pas sur ce que vos services réservent : | Poste | Prix | |---|---| | Processeur | 6 € par vCPU de la machine et par mois | | Mémoire | 3 € par Go de mémoire de la machine et par mois | | GPU | 100 € par GPU et par mois | | Adresse IP | 1 € par machine et par mois | | IP fixe de sortie | 5 € par mois | | Répartiteur de charge | 20 € par mois | | Volumes | 0,10 € par Go et par mois | Exemple : une machine Hetzner cpx22 (2 vCPU, 4 Go) coûte 19,99 € par mois chez Hetzner, plus 25 € pour Fransys (2 × 6 € + 4 × 3 € + 1 €), soit 44,99 € par mois. Sur votre propre compte chez l'hébergeur, il vous facture la machine directement : Fransys ne facture que sa part. ## Services managés | Poste | Prix | |---|---| | Sauvegardes (journaux de transactions compris) | 0,03 € par Go et par mois | | Registre de conteneurs | 0,05 € par Go et par mois | | Journaux | 0,25 € par Go reçu, puis 0,05 € par Go et par mois conservé | | Mesures | 4 € par tranche de 1 000 séries actives, par mois | | Trafic des machines | Au-delà du forfait gratuit de l'hébergeur, à prix coûtant | ## Où voir le prix d'une machine À la création d'un cluster, chaque machine affiche son prix par mois, et le détail du prix se met à jour à chaque choix. Les prix sont hors taxes. ## Estimer un projet Votre agent peut chiffrer un projet avec le catalogue du jour, par le MCP Fransys (outil `estimate_project`). Il ne calcule jamais un prix lui-même. --- # Crédits et paiement automatique > Recharger des crédits, ajouter un moyen de paiement, activer le paiement automatique et régler vos limites de dépense. Source : https://docs.fransys.cloud/budget/credits-et-paiement-automatique/ Vérifié sur la console le 2026-10-23. ## Recharger des crédits Dans **Budget**, **Recharger des crédits** : choisissez un montant ou saisissez-en un autre. La console dit combien de temps ce montant vous donne au rythme actuel. Un code promo s'applique avant le paiement ; la fenêtre affiche la remise, la TVA et le total. Le montant est débité tout de suite sur votre moyen de paiement. La facture apparaît dans **Factures et relevés**. À la première recharge, vos coordonnées de facturation et un moyen de paiement vous sont demandés en chemin. ## Moyens de paiement Carte bancaire ou prélèvement SEPA. La saisie se fait chez Stripe, le prestataire de paiement de Fransys : Fransys ne voit jamais les numéros. Choisissez le moyen **Par défaut** : c'est lui que débite le paiement automatique. ## Le paiement automatique **Paiement automatique en fin de période** : ce qui dépasse vos crédits est réglé automatiquement, en fin de période, sur votre moyen de paiement par défaut. L'infrastructure n'est jamais coupée, même en cas de retard de paiement. Coupé, seuls vos crédits paient la consommation, et l'infrastructure est éteinte 2 h avant leur épuisement. Pour le couper alors que vous avez consommé au-delà de vos crédits, couvrez d'abord ce montant. ## Les limites de dépense - **Limite mensuelle** : le total que la période ne doit pas dépasser. Avec le paiement automatique, vos services restent en ligne si elle est dépassée ; sans, ils sont coupés. - **Rythme maximum** : un repère de dépense par mois, indicatif. Fransys ne coupe rien s'il est dépassé. Au-delà, ce sont les maximums fixés par Fransys. Pour aller plus haut, écrivez à l'équipe. ## Le plus sûr Ajoutez un moyen de paiement, activez le paiement automatique, puis vérifiez vos limites. Voir [Ne jamais être coupé](https://docs.fransys.cloud/budget/ne-jamais-etre-coupe/). --- # Ne jamais être coupé > Ce qui arrive quand vos crédits s'épuisent, et les trois réglages pour que votre infrastructure reste toujours en ligne. Source : https://docs.fransys.cloud/budget/ne-jamais-etre-coupe/ Vérifié sur la console le 2026-10-23. ## Sans paiement automatique Seuls vos crédits paient la consommation. **L'infrastructure est éteinte 2 h avant l'épuisement des crédits.** La page **Budget** dit quand, par exemple : « Sans paiement automatique, l'infrastructure sera éteinte demain vers 14 h, 2 h avant l'épuisement des crédits. Rechargez avant pour l'éviter. » Si la période dépasse votre limite mensuelle, vos services sont coupés aussi. ## Avec le paiement automatique L'infrastructure n'est jamais coupée : ce qui dépasse vos crédits est réglé en fin de période sur votre moyen de paiement, même en cas de retard de paiement. Si la limite mensuelle est dépassée, vos services restent en ligne. ## Les trois réglages Tant que le paiement automatique est coupé, la carte **Pour ne jamais être coupé** de la page **Budget** montre ce qui manque : 1. **Moyen de paiement** : une carte ou un compte SEPA. 2. **Paiement automatique** : à activer. 3. **Limites de dépense** : à vérifier. **Activer le paiement automatique…** enchaîne les trois étapes. Rien n'est activé tant que vous n'avez pas cliqué sur **Activer**. Voir [Crédits et paiement automatique](https://docs.fransys.cloud/budget/credits-et-paiement-automatique/). ## Rien ne tourne Si aucune machine ne tourne, vos crédits sont intacts : ils ne sont consommés que lorsque des serveurs tournent, à l'heure. --- # Plafonds et limites > Les trois garde-fous de la dépense : le plafond d'un cluster en AutoPilot, la limite mensuelle de l'organisation, et le rythme maximum. Source : https://docs.fransys.cloud/budget/plafonds-et-limites/ Vérifié sur la console le 2026-10-23. ## Trois garde-fous | Garde-fou | Où | Ce qu'il fait | |---|---|---| | **Budget maximum** d'un cluster | Configuration du cluster | En AutoPilot, aucune machine n'est ajoutée au-delà. Vous êtes prévenu par e-mail. | | **Limite mensuelle** | Budget › Paiement automatique et limites | Le total que la période ne doit pas dépasser. Sans paiement automatique, les services sont coupés au-delà. | | **Rythme maximum** | Budget › Paiement automatique et limites | Un repère de dépense par mois, indicatif : rien n'est coupé s'il est dépassé. | ## Le plafond d'un cluster Il se règle à la création du cluster ou dans **Modifier la configuration**, en mode AutoPilot. Il couvre les serveurs et la part Fransys ; les volumes, sauvegardes et adresses IP viennent en plus. Voir [AutoPilot et plafond](https://docs.fransys.cloud/clusters/autopilot-et-plafond/#le-budget-maximum). Quand le coût réel du cluster dépasse son plafond, la page **Aujourd'hui** et la page du cluster le signalent : revoyez le plafond ou les machines. ## La limite mensuelle Dans **Budget**, **Modifier les limites**. La fenêtre affiche ce qui est prévu sur la période au rythme actuel, et vous prévient si la limite serait dépassée : - avec le paiement automatique, vos services restent en ligne ; - sans, ils sont coupés. ## Le rythme maximum Un repère, par mois, pour comparer avec le **Rythme actuel**. Il n'est jamais appliqué. ## Les maximums de Fransys Au-delà de vos limites, ce sont les maximums fixés par Fransys pour votre organisation. Pour aller plus haut, écrivez à l'équipe depuis le bouton d'aide. ## Bientôt Les alertes de budget à 80 % et 100 %, et l'effet des plans en attente sur la facture. --- # Factures et relevés > Où trouver vos factures de recharge et vos relevés de consommation, et renseigner vos coordonnées de facturation. Source : https://docs.fransys.cloud/budget/factures/ Vérifié sur la console le 2026-10-23. ## Deux documents - **Une facture à chaque recharge** de crédits (**Achat de crédits**). - **Un relevé de consommation** à la fin de chaque période (**Relevé**, du … au …). Tous sont dans **Budget**, rubrique **Factures et relevés**, en PDF, avec leur détail ligne par ligne. ## Le statut d'une facture **payée**, **à payer**, **impayée**, **brouillon** ou **annulée**. ## Coordonnées de facturation Rubrique **Coordonnées de facturation**, **Modifier** : - **Nom ou raison sociale** ; - **Adresse**, **Code postal**, **Ville**, **Pays** ; - **Numéro de TVA** (facultatif). Elles figurent sur vos factures et sont nécessaires pour recharger. Le pays fixe la TVA appliquée. ## Exporter la dépense **Où va votre argent** › **Exporter en CSV** : une ligne par ressource facturée, avec son début, sa fin et son montant. Voir [Comment Fransys facture](https://docs.fransys.cloud/budget/comment-fransys-facture/#où-va-votre-argent). ## Bientôt L'historique des crédits : rechargés et consommés. --- # Mon compte et organisation > Votre profil, vos comptes GitHub et GitLab, l'organisation active et ses membres, et les conditions d'utilisation. Source : https://docs.fransys.cloud/compte/mon-compte/ Vérifié sur la console le 2026-10-23. ## Ouvrir Mon compte Depuis le menu de votre compte, dans la barre de navigation (ou la feuille **Plus** sur téléphone) : **Mon compte**. ## Profil - **Nom affiché** : c'est lui qui apparaît dans le journal et sur les plans. - L'e-mail sert à vous connecter : il ne se change pas ici. - La date à laquelle vous avez accepté les conditions d'utilisation. ## Comptes de code **Comptes de code** relie vos comptes GitHub et GitLab, pour que Fransys récupère le code de vos dépôts. **Relier GitHub** (ou GitLab) vous emmène chez lui pour l'autoriser, puis vous ramène ici. - **Autoriser d'autres dépôts** : rouvre l'autorisation pour choisir les dépôts accessibles à Fransys. - **Délier** : les projets qui récupèrent leur code par ce compte risquent de ne plus pouvoir le faire. Vous pourrez le relier de nouveau à tout moment. Seuls GitHub et GitLab peuvent être reliés. ## Organisation Toutes les données affichées sont celles de l'organisation active. Si vous en avez plusieurs, **Basculer** recharge la console sur une autre. **Membres et rôles** : inviter des collègues et choisir ce que chacun peut faire. Ils se gèrent dans l'espace de connexion Fransys (**Gérer**, nouvel onglet). **Facturation de l'organisation** mène à la page **Budget**. ## Conditions d'utilisation À la première connexion, la console demande d'accepter les conditions d'utilisation de Fransys. On ne peut pas utiliser Fransys sans les accepter. ## Sécurité du compte Mot de passe, double authentification et sessions : voir [Sécurité du compte](https://docs.fransys.cloud/compte/securite-du-compte/). --- # Sécurité du compte > Changer votre mot de passe, activer la double authentification, fermer vos sessions sur d'autres appareils. Source : https://docs.fransys.cloud/compte/securite-du-compte/ Vérifié sur la console le 2026-10-23. ## Changer de mot de passe Dans **Mon compte**, rubrique **Sécurité**, **Mot de passe** › **Changer** : 1. **Envoyer le code** : Fransys envoie un code à votre adresse e-mail ; 2. saisissez le **Code reçu par email** et votre **Nouveau mot de passe** (8 caractères au moins) ; 3. **Changer le mot de passe**. Rien reçu ? Regardez les indésirables, ou **Renvoyer un code**. ## Double authentification Un code demandé à chaque connexion, en plus du mot de passe. **Gérer** ouvre l'espace de connexion Fransys dans un nouvel onglet, où vous l'activez. ## Sessions sur vos autres appareils **Gérer** ouvre l'espace de connexion, où vous voyez vos sessions et les fermez à distance. **Se déconnecter** ferme la session de cet appareil. ## Les clés d'agent Une clé d'agent donne accès à vos données en lecture : ne la partagez pas, et retirez celles qui ne servent plus. Voir [Brancher un agent](https://docs.fransys.cloud/agents/brancher-un-agent/#une-clé-par-agent). --- # Modèle de sécurité > Ce que Fransys protège par défaut, ce que vous réglez vous-même, et le sas entre votre agent et votre infrastructure. Source : https://docs.fransys.cloud/securite/modele-de-securite/ Vérifié sur la console le 2026-10-23. ## Par défaut, sans rien régler - **HTTPS partout** : chaque adresse publique a son certificat, généré et renouvelé tout seul, pour l'adresse en `fransysapp.com` comme pour vos domaines. - **Services internes** : un service sans accès depuis Internet n'est joignable que par les services de son projet. Les bases de données n'ont pas d'adresse publique tant que vous n'activez pas l'accès à distance. - **Projets isolés** : les services d'un projet ne voient pas ceux des autres projets du même cluster ; ils ne communiquent que par les liaisons que vous tracez. - **Identifiants générés** : les mots de passe des bases sont créés par Fransys et transmis aux services reliés par leurs variables. Pas de mot de passe par défaut. - **Retour arrière automatique** : un déploiement qui échoue est annulé, la version précédente reste en ligne. ## Les secrets - **Variables protégées** : la valeur est chiffrée et illisible ensuite, même pour vous. Elle n'apparaît ni dans l'export `.env`, ni dans les plans (elle y est masquée). - **Registre privé** : le mot de passe du registre est chiffré, comme une variable protégée. - **Comptes cloud** : Fransys vérifie la clé auprès de l'hébergeur, puis ne l'affiche plus jamais. - **Paiement** : la carte ou le compte bancaire se saisit chez Stripe ; Fransys ne voit jamais les numéros. ## Les agents passent par un sas - Une clé d'agent ne donne que des droits de lecture. - L'agent prépare des plans ; il n'a aucun outil pour les valider ou les exécuter. Une personne de l'équipe valide chaque plan dans la console. - Le journal garde qui a fait quoi, personne ou clé d'agent. - Retirer une clé coupe l'accès de l'agent tout de suite. Voir [Ce qu'un agent peut faire](https://docs.fransys.cloud/agents/ce-qu-un-agent-peut-faire/). ## Ce que vous pouvez durcir Dans le panneau d'une application, onglets **Sécurité** et **Avancé** : - **Exécuter sans root**, avec l'**Utilisateur d'exécution** et le **Groupe d'exécution** ; - **Autoriser l'élévation de privilèges** : coupez-la si votre application n'en a pas besoin ; - **Retirer les capacités Linux** ; - le **Profil seccomp** ; - le **Compte de service Kubernetes** et ses règles, si votre application parle à l'API Kubernetes. ## Ce qui reste à votre charge - Pas de secret dans le code ni dans l'image : passez par les variables protégées. - L'accès à distance d'une base ouvert seulement le temps nécessaire. - La double authentification sur votre compte. Voir [Sécurité du compte](https://docs.fransys.cloud/compte/securite-du-compte/). - Des clés d'agent nommées, une par agent ou par personne, retirées quand elles ne servent plus. --- # Où sont vos données > Vous choisissez l'hébergeur et le pays de chaque cluster. Ce qui en découle pour le droit applicable, et ce qui ne sort jamais de là. Source : https://docs.fransys.cloud/securite/ou-sont-vos-donnees/ Vérifié sur la console le 2026-10-23. ## Vous choisissez le pays À la création d'un cluster, vous choisissez l'hébergeur et la région. Vos services, leurs bases et leurs volumes tournent sur les machines de cette région. Ce choix ne change pas sans vous : pour déménager, vous créez un autre cluster. - **Où peuvent aller vos données ?** : **Union européenne** ne montre que les régions de l'Union. - Les régions hors Union européenne sont signalées « hors UE » partout dans la console. ## Des hébergeurs européens Fransys s'appuie sur des hébergeurs européens : Hetzner, Scaleway et Outscale (OVHcloud arrive bientôt), avec des régions en France, en Allemagne, en Finlande et en Pologne. La liste à jour des régions s'affiche à la création d'un cluster. Voir [Fournisseurs et régions](https://docs.fransys.cloud/reference/fournisseurs-et-regions/). ## Pourquoi c'est important - **Le droit applicable** : des hébergeurs de droit européen, dans des centres de données européens. Les hébergeurs américains sont soumis au Cloud Act, qui permet aux autorités américaines de demander des données stockées par des entreprises américaines, même en Europe. - **Vos obligations** : santé, finance, secteur public : la localisation des données est souvent une obligation. Voir [Conformité](https://docs.fransys.cloud/securite/conformite/). - **La latence** : des serveurs proches de vos utilisateurs européens répondent plus vite. ## Sur votre propre compte Avec [votre compte cloud](https://docs.fransys.cloud/clusters/compte-cloud/), les machines tournent sur votre compte chez l'hébergeur : le contrat et la facture des machines sont les vôtres. --- # Conformité > RGPD : ce que Fransys vous apporte et ce qui reste à votre charge. HDS et SecNumCloud : où en est Fransys. Source : https://docs.fransys.cloud/securite/conformite/ Vérifié sur la console le 2026-10-23. ## RGPD : ce que Fransys apporte - **La localisation** : vous choisissez le pays de chaque cluster ; rien n'est répliqué vers une région que vous n'avez pas choisie. - **Des hébergeurs européens**, soumis au RGPD, avec leurs propres certifications. - **Le chiffrement des échanges** : HTTPS sur toutes les adresses publiques. - **Les secrets protégés** : variables chiffrées, clés jamais réaffichées. ## RGPD : ce qui reste à votre charge L'infrastructure ne suffit pas : la conformité de votre application dépend de ce qu'elle fait des données. - la collecte et le consentement de vos utilisateurs ; - les traitements que fait votre application ; - la suppression des données sur demande, y compris dans vos sauvegardes, qui expirent selon leur durée de conservation. ## Données de santé (HDS) **Fransys n'est pas certifié Hébergeur de Données de Santé.** N'y hébergez pas de données de santé soumises à la certification HDS. ## SecNumCloud SecNumCloud est une qualification de l'ANSSI. C'est l'hébergeur **Outscale** qui est qualifié, pas Fransys : choisir Outscale ne rend pas votre service qualifié SecNumCloud. ## Une question précise Pour un questionnaire de sécurité ou une exigence réglementaire, écrivez à l'équipe depuis le bouton d'aide. --- # Partir de Fransys > Fransys ne vous enferme pas : votre code reste dans votre dépôt, vos bases tournent sur des moteurs standard, votre infrastructure sur du Kubernetes standard. Source : https://docs.fransys.cloud/securite/partir-de-fransys/ Vérifié sur la console le 2026-10-23. ## Votre code ne bouge pas Il reste dans votre dépôt GitHub ou GitLab. Fransys le construit et le déploie, sans le modifier : la merge request de la CI ajoute ses propres fichiers, sans toucher aux vôtres. Si vous partez, retirez-les. ## Vos données sont dans des formats standard PostgreSQL, MariaDB et Redis sont les moteurs que vous connaissez. Pour récupérer vos données : 1. activez **Autoriser l'accès à distance à la base** ; 2. exportez avec les outils habituels (`pg_dump`, `mysqldump`, `redis-cli --rdb`) ; 3. coupez l'accès à distance. ## Votre configuration se relit Services, images, ports, variables (hors valeurs protégées), domaines, liaisons : tout est lisible dans la console, et par votre agent (outil `get_project`). L'export `.env` donne les variables de chaque service. De quoi tout recréer ailleurs. ## Du Kubernetes standard Vos services tournent sur un cluster Kubernetes standard, chez un hébergeur standard, avec des images Docker standard. Pas de format propriétaire dans votre code ou vos images. ## Changer d'hébergeur sans partir Créez un cluster chez un autre hébergeur ou dans une autre région, puis rattachez-y vos projets (hors ligne d'abord). Les données des bases ne suivent pas : restaurez-les depuis une sauvegarde. Voir [Sauvegardes et restauration](https://docs.fransys.cloud/exploiter/sauvegardes/). --- # Déployer Laravel > Une application Laravel avec sa base, son cache, ses files d'attente, son planificateur et ses migrations, sur Fransys. Source : https://docs.fransys.cloud/guides/laravel/ Vérifié sur la console le 2026-10-23. ## Ce qu'il vous faut - Un projet rattaché à un cluster ([Premier déploiement](https://docs.fransys.cloud/demarrer/premier-deploiement/)). - Votre application dans un dépôt GitHub ou GitLab, ou une image Docker déjà construite. ## Le service de l'application Ajoutez une **Application** : Fransys la lance depuis une image Docker, celle que construit votre Dockerfile ou une image déjà publiée. Branchez le dépôt et la CI : voir [Depuis GitHub ou GitLab](https://docs.fransys.cloud/projets/github-gitlab/). Réglez le **Port du conteneur** sur celui où répond votre serveur web (par exemple `8080` avec les images `serversideup/php`, `80` avec un nginx classique). ## La base de données Ajoutez une base PostgreSQL ou MariaDB **reliée** à l'application. L'application reçoit ses variables de connexion : ouvrez l'onglet **Variables** pour voir leurs noms. Laravel attend `DB_HOST`, `DB_PORT`, `DB_DATABASE`, `DB_USERNAME` et `DB_PASSWORD`. Deux façons de faire correspondre : - **renommer** chaque variable reçue dans ce service (**Nom dans ce service**) ; - ou **ajouter** `DB_HOST=${…}` en citant la variable reçue, avec **Autoriser les références**. Ajoutez `DB_CONNECTION=pgsql` (ou `mariadb`). ## Les variables de l'application Importez votre `.env.example` (mode **Plusieurs variables (.env)**), puis complétez : - `APP_KEY` : générez-la sur votre poste avec `php artisan key:generate --show`, et ajoutez-la **protégée** ; - `APP_ENV=production`, `APP_DEBUG=false` ; - `APP_URL` : l'adresse du service, en `fransysapp.com` ou votre domaine. Gardez les secrets (clés d'API, mots de passe SMTP) en variables protégées. ## Redis pour le cache, les sessions et les files Ajoutez un Redis relié à l'application : elle reçoit `REDIS_HOST`, `REDIS_PORT` et `REDIS_PASSWORD`, les noms qu'attend Laravel. Puis `CACHE_STORE=redis`, `SESSION_DRIVER=redis`, `QUEUE_CONNECTION=redis`. ## Les migrations Dans **Commandes de déploiement**, ajoutez `php artisan migrate --force` à **Après la première installation** et à **Après une mise à jour**. Ajoutez au même endroit `php artisan optimize` si vous mettez la configuration en cache. ## Le planificateur Ajoutez une [tâche planifiée](https://docs.fransys.cloud/projets/taches-planifiees/) `php artisan schedule:run` chaque minute (`* * * * *`). Vos tâches restent décrites dans votre code (`routes/console.php` ou `app/Console/Kernel.php`). ## Les workers de files d'attente Fransys ne change pas la commande du conteneur. Faites lire un rôle à votre point d'entrée : ```sh #!/bin/sh # entrypoint.sh if [ "$CONTAINER_ROLE" = "worker" ]; then exec php artisan queue:work --tries=3 fi exec "$@" ``` Puis copiez le service de l'application et ajoutez `CONTAINER_ROLE=worker` à la copie. Votre agent sait préparer cette copie dans un plan. ## Les fichiers envoyés par vos utilisateurs Un conteneur redémarre sans ses fichiers. Pour `storage/app`, ajoutez un volume dans **Stockage** (point de montage `/var/www/html/storage/app`, selon votre image), ou utilisez un stockage objet compatible S3. ## Le temps réel Pour le broadcasting, ajoutez un service WebSocket relié à l'application et le pilote Pusher. Voir [Autres services](https://docs.fransys.cloud/projets/autres-services/#websocket). ## Le faire faire par votre agent Ouvrez l'agent dans le dossier du dépôt et donnez-lui la consigne du guide de lancement : il lit le Dockerfile, le `docker-compose` et le `.env.example`, puis prépare le port, les variables, les bases, le planificateur et les workers dans un plan, que vous relisez. Voir [Déployer votre code](https://docs.fransys.cloud/demarrer/deployer-votre-code/#le-faire-préparer-par-votre-agent). --- # Déployer Node.js et Next.js > Une API Node.js ou une application Next.js : le Dockerfile, le port, les variables lues au build, et la base. Source : https://docs.fransys.cloud/guides/node-nextjs/ Vérifié sur la console le 2026-10-23. ## Le Dockerfile Fransys déploie une image Docker. Un exemple pour Next.js, avec la sortie `standalone` (`output: 'standalone'` dans `next.config.js`) : ```dockerfile FROM node:22-alpine AS build WORKDIR /app COPY package.json package-lock.json ./ RUN npm ci COPY . . RUN npm run build FROM node:22-alpine WORKDIR /app ENV NODE_ENV=production PORT=3000 HOSTNAME=0.0.0.0 COPY --from=build /app/.next/standalone ./ COPY --from=build /app/.next/static ./.next/static COPY --from=build /app/public ./public EXPOSE 3000 CMD ["node", "server.js"] ``` Pour une API Node.js, le principe est le même : installer, construire si besoin, puis lancer le serveur. Écoutez sur `0.0.0.0`, pas sur `localhost`. ## Le service Ajoutez une **Application**, branchez le dépôt et la CI ([Depuis GitHub ou GitLab](https://docs.fransys.cloud/projets/github-gitlab/)), puis réglez le **Port du conteneur** sur `3000` (ou celui de votre `EXPOSE`). ## Les variables lues au build Next.js inscrit les variables `NEXT_PUBLIC_…` dans le code au moment du build. La CI de Fransys ne transmet pas encore les variables au build : - gardez ces valeurs dans votre code ou dans un fichier `.env.production` du dépôt, si elles ne sont pas secrètes ; - ou lisez-les au démarrage, côté serveur. Les autres variables (accès à la base, clés d'API) se règlent dans **Variables**, protégées si ce sont des secrets. ## La base de données Ajoutez une base PostgreSQL reliée à l'application, puis regardez dans **Variables** les noms reçus. Si votre ORM attend une seule URL (`DATABASE_URL` pour Prisma, par exemple), composez-la avec les références : ```txt DATABASE_URL=postgresql://${USER}:${PASSWORD}@${HOST}:${PORT}/${DATABASE} ``` en remplaçant chaque nom par celui de la variable reçue, et cochez **Autoriser les références**. ## Les migrations Dans **Commandes de déploiement**, à **Après la première installation** et **Après une mise à jour** : par exemple `npx prisma migrate deploy`. ## Plusieurs processus Un worker (BullMQ, par exemple) : faites lire un rôle à votre point d'entrée, puis copiez le service avec ce rôle. Voir [Application](https://docs.fransys.cloud/projets/application/#workers-files-dattente-tâches-planifiées). --- # Monorepo > Plusieurs applications dans un même dépôt : un service par application, chacun construit avec son propre Dockerfile. Source : https://docs.fransys.cloud/guides/monorepo/ Vérifié sur la console le 2026-10-23. ## Le principe Un service Fransys par application du dépôt, tous reliés au même dépôt. Chaque service a son pipeline, qui construit l'image avec le Dockerfile de son application. ```txt mon-depot/ └── apps/ ├── api/ │ └── Dockerfile └── front/ └── Dockerfile ``` ## Les étapes, pour chaque application 1. **Ajouter le service** : une **Application** par sous-dossier, avec un nom clair (`api`, `front`). 2. **Relier le dépôt** : la même origine du code, le même dépôt et la même branche. 3. **Brancher la CI** : Fransys ouvre une merge request qui ajoute son pipeline. 4. **Indiquer le Dockerfile** : dans votre dépôt, créez une variable de CI propre à ce service (sur GitHub : Settings › Secrets and variables › Actions › Variables), par exemple `DOCKERFILE_PATH_API` = `apps/api/Dockerfile`. Dans le fichier de pipeline ajouté par la merge request, remplacez la variable `DOCKERFILE_PATH` par la vôtre, puis renommez le fichier (par exemple `fransys_api.yml`) pour qu'il ne soit pas écrasé par celui du service suivant. 5. **Merger et vérifier** : quand le pipeline passe, le dernier commit apparaît dans le service. Recommencez pour chaque application, avec sa propre variable (`DOCKERFILE_PATH_FRONT`…). ## Conseils - Une faute dans le chemin du Dockerfile fait échouer le build : vérifiez-le dans le journal du pipeline. - Chaque push déclenche les pipelines de toutes les applications. Pour n'en construire qu'une, ajoutez un filtre de chemins à son pipeline (`paths:` sur GitHub Actions, `rules: changes:` sur GitLab CI). - La même logique vaut pour GitLab. --- # Depuis un docker-compose > Transposer un fichier docker-compose en services Fransys : chaque entrée, chaque réglage, à sa place. Source : https://docs.fransys.cloud/guides/docker-compose/ Vérifié sur la console le 2026-10-23. ## La correspondance | Dans le `docker-compose.yml` | Sur Fransys | |---|---| | un service avec `build:` | une **Application** depuis votre dépôt, avec la CI | | un service avec `image:` | une **Application** en **Image externe** | | `postgres`, `mysql`, `mariadb`, `redis` | une **base de données** managée, reliée aux applications | | `ports:` | le **Port du conteneur** (le port interne, celui de droite) | | `environment:` ou `env_file:` | **Variables**, en important le fichier `.env` | | `depends_on:` | une **liaison** entre les services | | `volumes:` (données) | un volume dans **Stockage** | | `command:` | pas de changement de commande : un rôle lu par le point d'entrée | | un conteneur cron | une **tâche planifiée** | ## Les bases Ne recopiez pas le conteneur de base du compose : ajoutez une base managée. Elle est sauvegardée, et ses identifiants arrivent dans les variables de l'application reliée. Adaptez les noms (`DB_HOST`…) en renommant les variables reçues, ou avec des références. Voir [Relier des services](https://docs.fransys.cloud/projets/relier-des-services/). ## Les noms d'hôte Dans le compose, une application joint la base par le nom du service (`db`). Sur Fransys, utilisez la variable d'adresse reçue par la liaison, pas un nom écrit en dur. ## Le plus rapide : votre agent Ouvrez l'agent dans le dossier du dépôt et demandez-lui : « Lis le docker-compose et prépare le plan Fransys équivalent dans le projet shop. » Il ajoute les services, les bases, les liaisons et les variables dans un plan, que vous relisez. --- # Migrer depuis Heroku > Passer une application Heroku sur Fransys : le Procfile, les config vars, Heroku Postgres, le Scheduler et les add-ons. Source : https://docs.fransys.cloud/guides/migrer-depuis-heroku/ Vérifié sur la console le 2026-10-23. ## La correspondance | Sur Heroku | Sur Fransys | |---|---| | un dyno `web` du Procfile | une **Application** | | un dyno `worker` | une copie du service, avec un rôle lu par le point d'entrée | | la phase `release` | **Commandes de déploiement** › **Avant une mise à jour** | | les config vars | **Variables**, en important un `.env` | | Heroku Postgres | une base **PostgreSQL** | | Heroku Redis | une base **Redis** | | Heroku Scheduler | une **tâche planifiée** | | un buildpack | un Dockerfile dans votre dépôt | | le domaine | **Ajouter un domaine**, puis l'enregistrement DNS | ## 1. Le Dockerfile Fransys construit une image Docker : ajoutez un Dockerfile à votre dépôt. Voir [Déployer Laravel](https://docs.fransys.cloud/guides/laravel/) ou [Node.js et Next.js](https://docs.fransys.cloud/guides/node-nextjs/). Écoutez sur le port de votre choix, réglé ensuite dans **Port du conteneur** (Heroku impose `$PORT`, Fransys non). ## 2. Le service et ses variables Ajoutez l'application et branchez la CI ([Depuis GitHub ou GitLab](https://docs.fransys.cloud/projets/github-gitlab/)). Récupérez vos config vars : ```sh heroku config -s -a mon-app > heroku.env ``` puis importez le fichier dans **Variables** (mode **Plusieurs variables (.env)**). Retirez `DATABASE_URL` et `REDIS_URL` : elles viendront des bases Fransys. Protégez les secrets. ## 3. Les données Ajoutez une base PostgreSQL reliée à l'application, activez son **accès à distance**, puis : ```sh heroku pg:backups:capture -a mon-app curl -o dump.backup "$(heroku pg:backups:url -a mon-app)" pg_restore --no-owner --no-acl -h -p -U -d dump.backup ``` avec les identifiants de la base Fransys. Coupez l'accès à distance une fois l'import fait. ## 4. Les workers et le scheduler - Chaque dyno `worker` : copiez le service et donnez-lui son rôle. Voir [Application](https://docs.fransys.cloud/projets/application/#workers-files-dattente-tâches-planifiées). - Chaque tâche du Scheduler : une [tâche planifiée](https://docs.fransys.cloud/projets/taches-planifiees/). ## 5. Basculer Déployez, vérifiez l'adresse en `fransysapp.com`, puis ajoutez votre domaine et changez le DNS. Gardez l'application Heroku en lecture seule le temps que le DNS se propage. Voir [Domaine et HTTPS](https://docs.fransys.cloud/projets/domaine-et-https/). --- # Limites et délais > Les limites de la plateforme, les durées à connaître (création d'un cluster, préparation d'un service, mesures) et les formats attendus. Source : https://docs.fransys.cloud/reference/limites/ Vérifié sur la console le 2026-10-23. ## Combien | Ressource | Limite | |---|---| | Projets, clusters, services | Pas de limite fixée par Fransys | | Machines par cluster | Selon l'hébergeur et la machine choisie | | Domaines par service | Pas de limite | | Dépense | Vos limites, puis les maximums fixés par Fransys pour l'organisation (à relever sur demande) | ## Combien de temps | Ce qui se passe | Durée | |---|---| | Créer un cluster (machines, puis Kubernetes) | Jusqu'à 15 minutes, puis quelques minutes **Dégradé** | | Un cluster qui ne démarre pas | Signalé au-delà de 25 minutes | | Préparer un nouveau service (ses réglages) | Une à deux minutes | | Recalculer les réglages après un choix | Quelques secondes | | Un service qui ne démarre pas | Signalé au-delà de 15 minutes | | Activer une clé d'agent | 10 à 15 secondes | | Importer un commit après un push | Le temps du pipeline ; au-delà de 10 minutes, voir [Dernier commit non importé](https://docs.fransys.cloud/projets/github-gitlab/#dernier-commit-non-importé) | | Prise en compte d'un enregistrement DNS | Jusqu'à quelques heures | ## À quel rythme | Mesure | Rythme | |---|---| | Mesures du monitoring | Toutes les 30 secondes | | Contrôles de santé des services | Chaque minute | | Mesures sur le schéma d'un projet | Dernière heure, relues toutes les 30 secondes | | Consommation des crédits | À l'heure, tant que des machines tournent | | Un mois de facturation | 730 heures | ## Formats | Champ | Format | |---|---| | Nom d'un projet, d'un cluster | 30 caractères au plus | | Domaine | Nom complet, sans `https://` ni chemin : `app.votre-domaine.fr` | | Variable d'environnement | `NOM=valeur` ; les noms sont mis en majuscules à l'import | | Expression cron | 5 champs : minute, heure, jour du mois, mois, jour de la semaine | | Mot de passe du compte | 8 caractères au moins | | Requête PromQL (outil `query_metrics`) | 1 000 caractères au plus, filtrée sur un cluster | Une limite vous bloque ? Écrivez à l'équipe : certaines s'ajustent. --- # Fournisseurs et régions > Les hébergeurs européens sur lesquels Fransys installe vos clusters, et comment choisir. Source : https://docs.fransys.cloud/reference/fournisseurs-et-regions/ Vérifié sur la console le 2026-10-23. ## Les hébergeurs | Hébergeur | Siège | Points forts | |---|---|---| | **Hetzner** | Allemagne | Le meilleur rapport qualité-prix, pour le développement et les petites productions. | | **Scaleway** | France | Infrastructure française, machines à GPU selon le stock. | | **Outscale** | France | Qualifié SecNumCloud par l'ANSSI (l'hébergeur, pas Fransys). | | **OVHcloud** | France | Bientôt disponible : pas encore proposé à la création d'un cluster. | Les pays : France, Allemagne, Finlande et Pologne. La liste des régions, leurs machines et leurs prix changent : la console affiche toujours l'état du jour à la création d'un cluster, avec le prix de la machine la moins chère de chaque région. ## Ce que la console signale - **Données dans l'UE**, ou **hors UE** pour une région hors de l'Union européenne ; - **GPU** pour une région qui propose des machines à GPU ; - « nécessite votre propre compte » quand la région exige [votre compte cloud](https://docs.fransys.cloud/clusters/compte-cloud/) ; - « aucune machine disponible ici » quand l'hébergeur n'a plus de stock. ## Choisir | Besoin | Hébergeur | |---|---| | Le budget le plus serré | Hetzner | | Des GPU | Scaleway, selon le stock | | Héberger en France | Scaleway, Outscale (OVHcloud bientôt) | | Un environnement qualifié SecNumCloud | Outscale | Vous pouvez avoir plusieurs clusters chez des hébergeurs différents, et répartir vos projets entre eux. ## Changer d'hébergeur Un cluster ne change pas d'hébergeur ni de région. Créez un autre cluster, puis rattachez-y vos projets. Voir [Partir de Fransys](https://docs.fransys.cloud/securite/partir-de-fransys/#changer-dhébergeur-sans-partir). --- # Outils MCP > La liste des outils du MCP Fransys, ce que fait chacun, et lesquels ne font que lire. Source : https://docs.fransys.cloud/reference/outils-mcp/ Vérifié sur la console le 2026-10-23. ## Lecture Ces outils ne changent rien. | Outil | Ce qu'il fait | |---|---| | `list_projects` | Les projets de l'organisation : id, nom, statut et clusters. | | `get_project` | Un projet et ses services : réglages (secrets masqués), variables, domaines, liaisons, changements en attente et erreurs de validation. | | `list_clusters` | Les clusters : hébergeur, région, état, nombre de machines, configuration et coût mensuel estimé. | | `get_cluster` | Un cluster : configuration, état, projets hébergés et coût mensuel estimé. | | `get_service_logs` | Les dernières lignes du journal d'un service. | | `get_service_health` | Les contrôles de santé d'un service : statut, message, dernier et prochain contrôle. | | `query_metrics` | Une requête PromQL instantanée sur un cluster. | | `list_plans` | Les plans de l'organisation, avec leur statut et leur avancement. | | `get_plan` | Un plan complet : tâches, avancement, décision. | | `get_plan_format` | Le format des plans : règles, catalogue des actions, exemples. À lire avant `prepare_plan`. | | `docs_search` | Cherche dans cette documentation les sections qui répondent à une question. | | `docs_read` | Lit une page ou une section de cette documentation, en Markdown. | | `draft_service_copy` | Rédige les tâches qui copient un service (réglages, variables, liaisons), à mettre dans un plan. Ne crée rien. | ## Plans Ces outils déposent ou changent un plan, jamais votre infrastructure : une personne valide chaque plan dans la console. | Outil | Ce qu'il fait | |---|---| | `prepare_plan` | Dépose un plan « À décider ». Rien n'est exécuté. | | `update_plan` | Modifie un plan préparé par l'agent, tant qu'il n'est pas validé. | | `cancel_plan` | Annule un plan préparé par l'agent, tant qu'il n'est pas validé. | | `revert_plan` | Propose un nouveau plan qui défait un plan exécuté. | ## Estimation | Outil | Ce qu'il fait | |---|---| | `get_estimation_guide` | Comment traduire un besoin en description de projet : questions à poser, criticité, taille des services. | | `list_server_types` | Les machines d'une région et leur prix mensuel. | | `estimate_project` | Le coût mensuel hors taxes d'un projet, avec le catalogue du jour. | ## Aucun outil pour exécuter Le MCP n'a aucun outil pour valider ou exécuter un plan. Voir [Ce qu'un agent peut faire](https://docs.fransys.cloud/agents/ce-qu-un-agent-peut-faire/). --- # Questions fréquentes > Les questions qu'on nous pose le plus, avec une réponse courte et le lien vers la page qui détaille. Source : https://docs.fransys.cloud/reference/faq/ Vérifié sur la console le 2026-10-23. ## Combien ça coûte pour commencer ? Pas d'abonnement ni de forfait. Vous payez à l'heure ce qui tourne : les machines au prix de l'hébergeur, plus la part Fransys. Voir [Comment Fransys facture](https://docs.fransys.cloud/budget/comment-fransys-facture/). ## Que se passe-t-il quand mes crédits sont épuisés ? Sans paiement automatique, l'infrastructure est éteinte 2 h avant l'épuisement des crédits. Avec le paiement automatique, elle n'est jamais coupée. Voir [Ne jamais être coupé](https://docs.fransys.cloud/budget/ne-jamais-etre-coupe/). ## Quels langages et frameworks ? Tout ce qui tourne dans une image Docker : Laravel, Symfony, Node.js, Next.js, Django, FastAPI, Go, Rust… Voir les [guides](https://docs.fransys.cloud/guides/laravel/). ## Combien de temps pour créer un cluster ? Jusqu'à 15 minutes. Il peut ensuite rester quelques minutes **Dégradé** : c'est normal. Voir [Créer un cluster](https://docs.fransys.cloud/clusters/creer-un-cluster/). ## Mon déploiement a échoué : je suis en panne ? Non : Fransys revient en arrière tout seul, votre dernière version reste en ligne. Le détail du service dit pourquoi le nouveau n'a pas démarré. Voir [Déployer et suivre](https://docs.fransys.cloud/projets/deployer-et-suivre/). ## Où sont mes données ? Dans le pays et chez l'hébergeur européen que vous choisissez pour chaque cluster. Voir [Où sont vos données](https://docs.fransys.cloud/securite/ou-sont-vos-donnees/). ## Fransys héberge-t-il des données de santé ? Non : Fransys n'est pas certifié HDS. Voir [Conformité](https://docs.fransys.cloud/securite/conformite/). ## Mon agent peut-il casser ma production ? Il ne peut que lire et préparer des plans. Une personne de l'équipe valide chaque plan avant qu'il s'exécute. Voir [Ce qu'un agent peut faire](https://docs.fransys.cloud/agents/ce-qu-un-agent-peut-faire/). ## Puis-je utiliser mon compte Hetzner, Scaleway ou Outscale ? Oui : les machines tournent alors sur votre compte, facturées par l'hébergeur. Voir [Votre compte cloud](https://docs.fransys.cloud/clusters/compte-cloud/). ## Puis-je partir avec mon code et mes données ? Oui : votre code reste dans votre dépôt, vos bases sont des PostgreSQL, MariaDB et Redis standard. Voir [Partir de Fransys](https://docs.fransys.cloud/securite/partir-de-fransys/). ## Comment joindre l'équipe ? Le bouton d'aide de la console ouvre une discussion avec nous. Ou par e-mail : kevin@fransys.cloud. --- # Nouveautés > Ce qui a changé dans Fransys, du plus récent au plus ancien. Source : https://docs.fransys.cloud/reference/nouveautes/ Vérifié sur la console le 2026-10-23. ## Octobre 2026 - **Une nouvelle documentation**, lisible par votre agent : chaque page en Markdown, `llms.txt`, et un index de recherche. Voir [La doc pour votre agent](https://docs.fransys.cloud/agents/pour-votre-agent/). - **Les plans** : votre agent prépare, vous validez. Relire, refuser, reprendre après un échec, revenir sur un plan exécuté. Voir [Les plans](https://docs.fransys.cloud/agents/plans/). - **Les clés d'agent** : un agent par clé, en lecture seule, avec le journal de ce que chacune a fait. Voir [Brancher un agent](https://docs.fransys.cloud/agents/brancher-un-agent/). - **Trois criticités** : Basique (une seule machine possible), Stable et Critique. Voir [Criticité](https://docs.fransys.cloud/clusters/criticite/). - **L'AutoPilot à toute criticité**, avec un budget maximum ou vos propres groupes de machines. Voir [AutoPilot et plafond](https://docs.fransys.cloud/clusters/autopilot-et-plafond/). - **Les sauvegardes de MariaDB et Redis**, en plus de PostgreSQL. Voir [Sauvegardes et restauration](https://docs.fransys.cloud/exploiter/sauvegardes/). - **Le paiement automatique et les limites de dépense**, pour ne jamais être coupé. Voir [Ne jamais être coupé](https://docs.fransys.cloud/budget/ne-jamais-etre-coupe/). - **L'import de variables depuis un `.env`**, avec aperçu et gestion des doublons. Voir [Variables et secrets](https://docs.fransys.cloud/projets/variables-et-secrets/).