# 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, OVHcloud, Outscale), 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.

## 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, l'expression cron, et le planificateur Laravel.
- [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 : llms.txt, la doc complète en un fichier, 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.