Se rendre au contenu

Gitea et Forgejo pour les non-devs : la gestion documentaire versionnée pour équipes techniques

Vos fichiers de configuration méritent mieux qu'un dossier partagé et un fichier « config_final_v3_FINAL.txt ».

TL;DR : Gitea et Forgejo sont des plateformes de gestion de versions légères, auto-hébergées, avec une interface web accessible. Elles sont idéales pour les équipes techniques qui gèrent des fichiers de configuration, des scripts et de la documentation d'infrastructure : on sait qui a changé quoi, quand, et pourquoi. Pour la gestion documentaire générale (Word, PDF, présentations), Nextcloud reste le meilleur choix.


Dans cet article

Dans la plupart des PME, la configuration des serveurs vit dans un mélange de fichiers texte éparpillés, de courriels transférés trois fois, et de notes mentales du gars qui a quitté en décembre. Quelqu'un change un paramètre de pare-feu un vendredi soir, ça brise quelque chose le lundi, et personne ne sait ce qui a été touché.

Le problème n'est pas que votre équipe est désorganisée. Le problème, c'est que les outils classiques de partage de fichiers ne sont pas conçus pour suivre les modifications ligne par ligne. Un fichier Nginx ou un script PowerShell dans un dossier partagé, c'est un accident qui attend de se produire.

Il existe une catégorie d'outils qui règle exactement ce problème. On parle de plateformes de gestion de versions : des logiciels qui enregistrent chaque modification, par qui, quand, et avec un commentaire qui explique pourquoi. Les développeurs utilisent ça depuis des décennies. Les interfaces modernes rendent la chose accessible sans jamais ouvrir un terminal.

Schéma : l'historique d'un fichier de configuration Schéma de l'historique d'un fichier de configuration dans une interface web de gestion de versions. Quatre entrées, de la plus récente à la plus ancienne, chacune avec son auteur et le commentaire qui explique le changement. Le vendredi soir qui a tout cassé porte un nom et une heure. Historique · pare-feu.conf il y a 2 jours, par S. R. ouverture du port 8443 pour le portail il y a 3 semaines, par M. T. retrait d'une règle devenue inutile il y a 2 mois, par S. R. restriction de l'accès SSH à deux adresses il y a 7 mois, par M. T. version initiale versée au dépôt Qui, quand, et surtout pourquoi : le commentaire est obligatoire.


C'est quoi ?

Gitea et Forgejo sont des applications web auto-hébergées qui fonctionnent avec Git, le système de gestion de versions le plus utilisé au monde : en 2022, près de 94 % des répondants au sondage annuel de Stack Overflow s'en servaient. En termes simples : on dépose ses fichiers dans un dépôt (un dossier structuré), et chaque modification est enregistrée avec un historique complet.

L'interface web permet de naviguer dans les fichiers, voir les modifications, comparer les versions, et même éditer directement dans le navigateur. Pas besoin de ligne de commande pour les opérations courantes.

Forgejo est né en 2022 d'un fork de Gitea, quand une partie de la communauté a voulu garder le projet sous une gouvernance communautaire. Les deux offrent encore à peu près les mêmes fonctions, mais chacun suit sa propre route depuis 2024. On y revient plus bas.


Pour quoi c'est vraiment utile

On ne parle pas ici de remplacer votre Nextcloud ou votre SharePoint. On parle de gérer un type de contenu bien précis : les fichiers texte techniques.

Pensez aux fichiers de configuration de serveurs (Apache, Nginx, postfix), aux scripts d'automatisation (Bash, PowerShell, Python), aux runbooks et procédures techniques en Markdown, aux fichiers d'infrastructure as code (Ansible, Terraform, Docker Compose), et à la documentation d'architecture réseau.

Le point commun : ce sont tous des fichiers texte où chaque ligne compte, où une erreur peut tout casser, et où savoir qui a changé quoi est critique.


Ce que l'interface web permet de faire sans terminal

C'est là que Gitea et Forgejo se démarquent des solutions Git classiques en ligne de commande. L'interface web couvre les besoins courants.

On peut naviguer dans l'arborescence des fichiers, exactement comme un explorateur de fichiers. On peut voir l'historique complet d'un fichier : chaque modification est affichée avec un diff (les lignes ajoutées en vert, les lignes retirées en rouge). On peut éditer un fichier directement dans le navigateur et écrire un message qui explique la modification.

Il y a aussi un wiki intégré pour la documentation d'équipe, un système de tickets (issues) pour suivre les problèmes et les demandes, et des notifications pour savoir quand quelqu'un modifie quelque chose.

Pour une équipe technique qui n'a pas envie de vivre dans un terminal, c'est amplement suffisant pour les opérations du quotidien.

Schéma : ce que montre une comparaison de versions Schéma d'une comparaison entre deux versions d'un fichier de configuration. Trois lignes inchangées servent de repère, une ligne retirée est marquée d'un signe moins, deux lignes ajoutées sont marquées d'un signe plus. On voit la ligne exacte qui a changé, pas seulement que le fichier a changé. Comparaison · pare-feu.conf listen 443 ssl; server_name portail.exemple.ca; - allow 0.0.0.0/0; + allow 198.51.100.0/24; + deny all; access_log /var/log/portail.log; La ligne exacte, pas seulement le fichier : c'est ça qui raccourcit le lundi matin.


Forgejo vs Gitea vs GitLab : le comparatif

Les trois options s'auto-hébergent, mais elles ne jouent pas dans la même catégorie de poids.

Critère Forgejo Gitea GitLab CE
Licence GPL v3+ depuis la version 9.0 (2024), MIT avant MIT, avec une édition Enterprise payante vendue à part MIT (version CE)
Mémoire Aucun chiffre publié, se dit dix fois plus sobre que les autres forges 2 cœurs et 1 Go suffisent pour une petite équipe 16 Go comme point de départ, 8 Go au strict minimum
Installation Un seul binaire ou Docker Un seul binaire ou Docker Complexe, plusieurs services
Interface web Moderne, rapide Moderne, rapide Complète mais lourde
Wiki intégré Oui Oui Oui
CI/CD intégré Forgejo Actions (proche de GitHub Actions, sans compatibilité complète) Gitea Actions Oui, très complet
Complexité Simple Simple Élevée
Public cible Petites et moyennes équipes Petites et moyennes équipes Grandes organisations

GitLab CE est un excellent produit, mais c'est un paquebot : sa documentation pose 16 Go de mémoire comme point de départ pour un seul serveur. Pour une PME qui veut gérer ses configurations et ses scripts, c'est comme acheter un camion 18 roues pour livrer des pizzas. Gitea et Forgejo font le travail avec une fraction des ressources.


Forgejo ou Gitea : lequel choisir?

En octobre 2022, des responsables de Gitea ont créé une entreprise, Gitea Limited, et lui ont confié les noms de domaine et la marque du projet. Une partie de la communauté y a vu une prise de contrôle faite sans consultation. Une lettre ouverte est restée sans réponse, et Forgejo a été lancé en décembre 2022. Codeberg e.V., un organisme allemand sans but lucratif, en garde les noms de domaine.

Pendant un an, Forgejo est resté une version de Gitea avec quelques ajouts. En février 2024, il est devenu un fork complet qui trace sa propre route. En août 2024, sa version 9.0 est passée à la licence GPL v3+, une licence copyleft : le code et ce qu'on en dérive doivent rester libres. Gitea, lui, est aujourd'hui porté par CommitGo, une filiale de Gitea Limited qui vend une édition Enterprise (authentification SAML et journal d'audit, entre autres) et une offre hébergée.

Pour une PME qui héberge ça chez soi, les deux font le travail au quotidien. La différence tient à la gouvernance : Forgejo est mené par ses contributeurs, Gitea s'appuie sur une entreprise qui offre du support commercial. Mieux vaut trancher au départ. Passer de Gitea à Forgejo se faisait autrefois par simple remplacement, mais ce n'est plus garanti pour les versions de Gitea sorties après le fork. Chez Blue Fox, on recommande Forgejo : on privilégie les projets dont la gouvernance est communautaire.


Cas concret : une équipe TI qui gère 15 serveurs

Prenons un exemple typique. Votre équipe TI maintient 15 serveurs Linux : quelques serveurs web, une base de données, un serveur de courriel, un pare-feu. Les fichiers de configuration vivent un peu partout : certains sur les serveurs directement, d'autres dans un dossier partagé « pas touche », d'autres dans la tête de Martin.

Avec Forgejo, on crée un dépôt par serveur (ou un dépôt central avec un dossier par serveur). Chaque modification de configuration passe par le dépôt : on change le fichier, on écrit un message du genre « Ouverture du port 8443 pour le nouveau service de rapports », et c'est enregistré. Quand quelque chose brise, on peut voir exactement ce qui a changé dans les derniers jours et revenir en arrière en quelques clics.

Les runbooks (les procédures « quoi faire quand X arrive ») vivent dans le wiki. Les demandes de changement passent par les tickets. Et quand Martin part en vacances, personne n'est dans le noir.


Par où commencer

Le plus sûr est de commencer petit, avec un seul dépôt et quelques règles simples.

  1. Un premier lot modeste. Les fichiers de configuration d'un ou deux serveurs, ou les procédures de l'équipe. Pas tout le parc d'un coup.
  2. Des messages qui disent pourquoi. « Correction » ne dira rien à personne dans six mois. « Retrait de l'accès SSH public après l'audit » dit tout.
  3. Aucun secret dans le dépôt. Les mots de passe, clés et jetons d'accès vont dans un coffre de mots de passe comme Vaultwarden, jamais dans un fichier versionné. L'historique garde tout : un mot de passe versé une seule fois reste lisible dans les anciennes versions, même après l'avoir effacé du fichier.
  4. Une sauvegarde du serveur lui-même. L'historique protège contre une mauvaise modification, pas contre la perte de la machine qui le contient. Le dépôt se sauvegarde comme le reste, selon la règle 3-2-1 des sauvegardes.

Après quelques semaines, le réflexe s'installe : avant de toucher un serveur, on regarde l'historique, et après, on écrit sa ligne.


Ce que ça ne fait pas (et c'est correct)

Gitea et Forgejo ne sont pas la solution à tout.

Pour les documents bureautiques (Word, Excel, PowerPoint), c'est le mauvais outil. Git est conçu pour les fichiers texte. Un fichier .docx dans Git, ça fonctionne techniquement, mais on perd tous les avantages du diff ligne par ligne. Pour ça, Nextcloud avec son versionnement intégré est beaucoup plus adapté.

La courbe d'apprentissage est réelle. Même avec l'interface web, les concepts de Git (commits, branches, merge) prennent du temps à apprivoiser pour quelqu'un qui n'a jamais touché à ça. Il faut prévoir un accompagnement au début.

Et si votre équipe est petite (une ou deux personnes), avec peu de fichiers de configuration, ça peut être trop lourd pour le besoin. Un dossier bien organisé dans Nextcloud avec des notes de changement dans un fichier texte peut suffire.

Notre recommandation pour choisir le bon outil :

  1. Moins de 5 fichiers de config et une petite équipe : un dossier Nextcloud suffit.
  2. Équipe technique de 3+ personnes avec des serveurs à gérer : Forgejo.
  3. Grande organisation avec des besoins CI/CD avancés : GitLab CE.


La position Blue Fox

Pour les équipes techniques qui ont besoin de suivre leurs configurations et leurs scripts, on recommande Forgejo. C'est léger, ça s'installe sous forme d'un seul programme ou d'un conteneur Docker, et ça tourne sur un petit serveur. Il trouve naturellement sa place à côté de Nextcloud : Forgejo pour le technique, Nextcloud pour le reste.

On accompagne aussi les équipes dans l'adoption. Parce que l'outil est simple, mais les habitudes de travail, ça se change avec du support, pas avec un courriel qui dit « voici le nouveau système, bonne chance ».

On aide les PME à mettre en place leur infrastructure de gestion de versions. Discutons de votre infrastructure


En résumé

Gitea et Forgejo ne vont pas révolutionner votre entreprise du jour au lendemain. Mais si votre équipe technique passe du temps à chercher « c'est qui qui a changé ça » ou à reconstruire des configurations perdues, c'est exactement le genre d'outil qui règle le problème pour de bon. Léger, simple, auto-hébergé, et conçu pour le travail quotidien des équipes qui gèrent de l'infrastructure.

Discutons de votre infrastructure.


Sources

Héberger son propre courriel : est-ce que ça vaut vraiment la peine?
Un portrait franc du courriel autohébergé pour les PME et OBNL du Québec