# Fransys

> Fransys est un PaaS européen opéré : il met vos applications en ligne sur un cluster Kubernetes chez un hébergeur européen (Hetzner, Scaleway, Outscale ; OVHcloud bientôt), les surveille et les fait grandir sous un plafond de budget. Votre agent prépare des plans chiffrés ; une personne de l’équipe les valide.

La documentation complète en un fichier : https://docs.fransys.cloud/llms-full.txt. Chaque page existe aussi en Markdown (liens ci-dessous). Index de recherche par section : https://docs.fransys.cloud/search-index.json. In English: https://docs.fransys.cloud/en/llms.txt.

## Démarrer

- [Ce que fait Fransys](https://docs.fransys.cloud/demarrer/ce-que-fait-fransys.md) : 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.
- [Premier déploiement](https://docs.fransys.cloud/demarrer/premier-deploiement.md) : Une première application en ligne, en HTTPS, sur un cluster européen. Le parcours « Premier lancement » de la console, étape par étape.
- [Déployer votre code](https://docs.fransys.cloud/demarrer/deployer-votre-code.md) : Mettre en ligne une application depuis un dépôt GitHub ou GitLab, construite à chaque push par l'intégration continue de Fransys.
- [Les mots de Fransys](https://docs.fransys.cloud/demarrer/les-mots-de-fransys.md) : Projet, service, cluster, plan, crédits… Ce que veut dire chaque mot de la console, en une ou deux phrases.
- [Avant la production](https://docs.fransys.cloud/demarrer/avant-la-production.md) : La liste à parcourir avant d'ouvrir votre application au public : cluster, code, base, variables, domaine, budget, accès.

## Projets et services

- [Projets](https://docs.fransys.cloud/projets/projets.md) : 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.
- [Application](https://docs.fransys.cloud/projets/application.md) : 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.
- [Depuis GitHub ou GitLab](https://docs.fransys.cloud/projets/github-gitlab.md) : Relier votre compte GitHub ou GitLab, brancher l'intégration continue de Fransys, et que faire quand un commit n'arrive pas.
- [PostgreSQL, MariaDB, Redis](https://docs.fransys.cloud/projets/bases-de-donnees.md) : Ajouter une base de données managée et sauvegardée, la relier à votre application, et ce qui arrive à ses données.
- [Relier des services](https://docs.fransys.cloud/projets/relier-des-services.md) : Ce qui passe d'un service à l'autre quand on les relie, comment relier et délier, et renommer une variable reçue.
- [Variables et secrets](https://docs.fransys.cloud/projets/variables-et-secrets.md) : Ajouter des variables d'environnement une à une ou depuis un fichier .env, protéger un secret, citer une autre variable, exporter.
- [Domaine et HTTPS](https://docs.fransys.cloud/projets/domaine-et-https.md) : L'adresse fournie par Fransys, votre propre domaine, l'enregistrement DNS à créer et le certificat HTTPS.
- [Déployer et suivre](https://docs.fransys.cloud/projets/deployer-et-suivre.md) : Ce qui part au déploiement, ce qui le bloque, le retour arrière automatique, et l'historique des versions.
- [Tâches planifiées](https://docs.fransys.cloud/projets/taches-planifiees.md) : Lancer une commande à heure fixe (export, nettoyage, envoi d'e-mails) : la fréquence et l'expression cron.
- [Autres services](https://docs.fransys.cloud/projets/autres-services.md) : Les services qui ne sont ni une application ni une base de données, comme le WebSocket ou le gestionnaire de secrets.
- [Revenir en arrière](https://docs.fransys.cloud/projets/revenir-en-arriere.md) : Le retour arrière automatique d'un déploiement raté, revenir sur un plan exécuté, et annuler des changements avant de déployer.

## Clusters

- [Créer un cluster](https://docs.fransys.cloud/clusters/creer-un-cluster.md) : 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.
- [Criticité](https://docs.fransys.cloud/clusters/criticite.md) : Basique, Stable ou Critique. Ce que chaque criticité installe au minimum, et laquelle choisir.
- [AutoPilot et plafond](https://docs.fransys.cloud/clusters/autopilot-et-plafond.md) : Laisser Fransys choisir et ajouter les machines sous un budget maximum, fixer vos propres groupes, ou garder un nombre fixe de machines.
- [Votre compte cloud](https://docs.fransys.cloud/clusters/compte-cloud.md) : 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.
- [Montée en charge](https://docs.fransys.cloud/clusters/montee-en-charge.md) : Tenir un pic de trafic : plus de répliques pour un service, plus de machines pour le cluster, et ce que ça coûte.
- [GPU](https://docs.fransys.cloud/clusters/gpu.md) : 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.
- [Modifier, mettre hors ligne, supprimer](https://docs.fransys.cloud/clusters/modifier-ou-supprimer.md) : Changer la configuration d'un cluster, l'arrêter pour ne plus payer ses machines, le remettre en ligne ou le supprimer.

## Agents et plans

- [Brancher un agent](https://docs.fransys.cloud/agents/brancher-un-agent.md) : Brancher Claude Code, Cursor ou Claude Desktop sur Fransys par le MCP, avec une clé d'agent en lecture seule.
- [Les plans](https://docs.fransys.cloud/agents/plans.md) : 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.
- [Ce qu'un agent peut faire](https://docs.fransys.cloud/agents/ce-qu-un-agent-peut-faire.md) : Ce que votre agent peut lire, ce qu'il peut préparer, et ce qu'il ne peut jamais faire sur Fransys.
- [Bien formuler une demande](https://docs.fransys.cloud/agents/bien-formuler-une-demande.md) : Des demandes à votre agent qui donnent un bon plan du premier coup, par situation.
- [Équipe et droits](https://docs.fransys.cloud/agents/equipe-et-droits.md) : Bientôt : décider qui peut faire quoi dans votre organisation, personnes et agents, et des règles de validation des plans.
- [La doc pour votre agent](https://docs.fransys.cloud/agents/pour-votre-agent.md) : 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.

## Exploiter

- [La page Aujourd'hui](https://docs.fransys.cloud/exploiter/aujourd-hui.md) : 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.
- [Monitoring](https://docs.fransys.cloud/exploiter/monitoring.md) : Lire l'état d'un cluster et de ses services, leur consommation, leurs machines, et le détail d'un service en difficulté.
- [États d'un projet, d'un cluster, d'un service](https://docs.fransys.cloud/exploiter/etats.md) : Ce que veut dire chaque état affiché par la console, et quoi faire quand il n'est pas au vert.
- [Sauvegardes et restauration](https://docs.fransys.cloud/exploiter/sauvegardes.md) : Les sauvegardes automatiques de PostgreSQL, MariaDB et Redis, où les voir, et comment repartir d'une sauvegarde.
- [Journal](https://docs.fransys.cloud/exploiter/journal.md) : Qui a fait quoi, quand : chaque modification faite dans la console et chaque plan préparé par un agent y laisse une trace.
- [Notifications](https://docs.fransys.cloud/exploiter/notifications.md) : 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.
- [Alertes](https://docs.fransys.cloud/exploiter/alertes.md) : Bientôt : être prévenu quand un service ou un budget dérape, avec une solution déjà préparée.

## Budget et facturation

- [Comment Fransys facture](https://docs.fransys.cloud/budget/comment-fransys-facture.md) : Des crédits consommés à l'heure, sans abonnement. Ce que vous payez, où le voir, et vos factures.
- [Grille tarifaire](https://docs.fransys.cloud/budget/grille-tarifaire.md) : Ce que Fransys facture en plus du prix de l'hébergeur, poste par poste.
- [Crédits et paiement automatique](https://docs.fransys.cloud/budget/credits-et-paiement-automatique.md) : Recharger des crédits, ajouter un moyen de paiement, activer le paiement automatique et régler vos limites de dépense.
- [Ne jamais être coupé](https://docs.fransys.cloud/budget/ne-jamais-etre-coupe.md) : Ce qui arrive quand vos crédits s'épuisent, et les trois réglages pour que votre infrastructure reste toujours en ligne.
- [Plafonds et limites](https://docs.fransys.cloud/budget/plafonds-et-limites.md) : 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.
- [Factures et relevés](https://docs.fransys.cloud/budget/factures.md) : Où trouver vos factures de recharge et vos relevés de consommation, et renseigner vos coordonnées de facturation.

## Compte et organisation

- [Mon compte et organisation](https://docs.fransys.cloud/compte/mon-compte.md) : Votre profil, vos comptes GitHub et GitLab, l'organisation active et ses membres, et les conditions d'utilisation.
- [Sécurité du compte](https://docs.fransys.cloud/compte/securite-du-compte.md) : Changer votre mot de passe, activer la double authentification, fermer vos sessions sur d'autres appareils.

## Sécurité et souveraineté

- [Modèle de sécurité](https://docs.fransys.cloud/securite/modele-de-securite.md) : 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.
- [Où sont vos données](https://docs.fransys.cloud/securite/ou-sont-vos-donnees.md) : 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à.
- [Conformité](https://docs.fransys.cloud/securite/conformite.md) : RGPD : ce que Fransys vous apporte et ce qui reste à votre charge. HDS et SecNumCloud : où en est Fransys.
- [Partir de Fransys](https://docs.fransys.cloud/securite/partir-de-fransys.md) : 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.

## Guides

- [Déployer Laravel](https://docs.fransys.cloud/guides/laravel.md) : Une application Laravel avec sa base, son cache, ses files d'attente, son planificateur et ses migrations, sur Fransys.
- [Déployer Node.js et Next.js](https://docs.fransys.cloud/guides/node-nextjs.md) : Une API Node.js ou une application Next.js : le Dockerfile, le port, les variables lues au build, et la base.
- [Monorepo](https://docs.fransys.cloud/guides/monorepo.md) : Plusieurs applications dans un même dépôt : un service par application, chacun construit avec son propre Dockerfile.
- [Depuis un docker-compose](https://docs.fransys.cloud/guides/docker-compose.md) : Transposer un fichier docker-compose en services Fransys : chaque entrée, chaque réglage, à sa place.
- [Migrer depuis Heroku](https://docs.fransys.cloud/guides/migrer-depuis-heroku.md) : Passer une application Heroku sur Fransys : le Procfile, les config vars, Heroku Postgres, le Scheduler et les add-ons.

## Référence

- [Limites et délais](https://docs.fransys.cloud/reference/limites.md) : 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.
- [Fournisseurs et régions](https://docs.fransys.cloud/reference/fournisseurs-et-regions.md) : Les hébergeurs européens sur lesquels Fransys installe vos clusters, et comment choisir.
- [Outils MCP](https://docs.fransys.cloud/reference/outils-mcp.md) : La liste des outils du MCP Fransys, ce que fait chacun, et lesquels ne font que lire.
- [Questions fréquentes](https://docs.fransys.cloud/reference/faq.md) : Les questions qu'on nous pose le plus, avec une réponse courte et le lien vers la page qui détaille.
- [Nouveautés](https://docs.fransys.cloud/reference/nouveautes.md) : Ce qui a changé dans Fransys, du plus récent au plus ancien.