Aller au contenu principal
BlogNT
GitHub n’est plus votre seule option : vous pouvez héberger vos dépôts sur Forgejo

Décryptage

GitHub n’est plus votre seule option : vous pouvez héberger vos dépôts sur Forgejo

L'ESSENTIEL
  • Forgejo est une forge logicielle auto-hébergée, née en 2022 d’un fork de Gitea, qui fonctionne sur du matériel modeste.
  • La plateforme gère les dépôts, les pull requests, les tickets et propose un système de CI/CD compatible avec la syntaxe YAML.
  • L’auto-hébergement implique d’assurer soi-même la maintenance, la sécurité, les sauvegardes et la gestion des runners.

GitHub s’est imposé comme la plateforme incontournable pour héberger des projets logiciels. Pourtant, cette position dominante ne convient pas à tout le monde. Pour reprendre le contrôle de certains de mes dépôts et de leur gestion, j’ai choisi Forgejo, une solution open source que je peux installer sur mon propre matériel.

Publicité

Une décision qui m’a apporté davantage d’indépendance, mais aussi son lot de contraintes et de responsabilités.

Forgejo : héberger ses dépôts Git sur son propre serveur

Forgejo est une forge logicielle auto-hébergée, conçue pour fonctionner sur une infrastructure que l’on contrôle soi-même. Le projet est né en décembre 2022 sous la forme d’un fork de Gitea. Son histoire est étroitement liée à une évolution de la gouvernance de ce dernier : une entreprise à but lucratif, dirigée par son principal mainteneur, a repris les marques et les opérations de Gitea. Après avoir conservé dans un premier temps une forte proximité avec le projet d’origine, Forgejo est devenu un fork indépendant au début de 2024. Les deux bases de code évoluent depuis séparément, avec leurs propres orientations.

L’un des atouts de Forgejo réside dans sa légèreté. La plateforme rassemble les fonctions essentielles d’une forge moderne : dépôts Git, pull requests, suivi des tickets, CI/CD et registre de paquets. Le tout peut fonctionner sur du matériel modeste, avec une consommation de mémoire vive annoncée autour de 100 Mo.

Publicité

Développé en Go, Forgejo est distribué sous la forme d’un binaire unique et dispose également d’une image officielle pour les conteneurs. Il peut ainsi être installé sur un ancien ordinateur portable, un mini-PC ou un ordinateur monocarte. Une configuration DockerDocker est une plateforme de développement qui facilite la création, le déploiement et l'exécution d'applications dans des conteneurs logiciels. Lire la fiche Compose relativement simple, avec un seul service et un volume de données, suffit pour démarrer. Pour un usage individuel, SQLite peut convenir à de nombreuses petites installations. PostgreSQL devient toutefois préférable lorsque plusieurs personnes utilisent simultanément le serveur.

La partie la plus délicate concerne davantage l’infrastructure que Forgejo lui-même. Une instance accessible depuis Internet nécessite généralement un nom de domaine, une connexion HTTPS et un moyen sécurisé d’accéder aux dépôts Git. Un reverse proxy comme Caddy ou Nginx peut assurer la gestion du HTTPS, tandis que SSH permet d’effectuer les opérations Git. Une installation limitée au réseau local est plus simple, mais doit tout de même bénéficier de protections adaptées.

Mon installation en pratique : Forgejo sur un Mac en quelques minutes

J’ai testé Forgejo sur mon Mac (Apple Silicon), sans Docker, via Homebrew. Une seule commande a suffi : brew install forgejo. Le paquet occupe environ 112 Mo une fois installé, et forgejo --version confirme la version 17.0.1, compilée avec la prise en charge de SQLite.

Pour le lancer, deux possibilités : brew services start forgejo pour un service qui redémarre à chaque ouverture de session, ou forgejo web pour un lancement ponctuel. Quelques secondes plus tard, l’interface répondait sur http://localhost:3000.

Installation de Forgejo avec Homebrew
Installation et démarrage de Forgejo avec Homebrew (sortie des commandes, mise en forme pour l’article).

L’assistant de configuration initiale propose MySQL par défaut. J’ai choisi SQLite3, largement suffisant pour un usage personnel, et conservé les chemins par défaut de Homebrew pour la base de données et les dépôts.

Le seul accroc : le compte administrateur

Je voulais valider l’installation sans créer de compte administrateur dans l’assistant. Forgejo refuse : il est impossible de désactiver la création de comptes avant d’avoir créé un administrateur. Il faut décocher « Désactiver la création de compte », puis s’inscrire : le premier compte créé devient automatiquement administrateur. Mieux vaut le faire rapidement, puis refermer les inscriptions avec DISABLE_REGISTRATION = true dans la section [service] du fichier app.ini.

Page d'inscription de Forgejo
Page d’inscription de Forgejo : le premier compte créé devient administrateur.

En résumé, de la commande d’installation à l’écran de connexion, quelques minutes suffisent. Les vraies difficultés se trouvent ailleurs : exposition sur Internet, sauvegardes, runners.

Publicité

Migrer ses dépôts GitHub vers Forgejo

La migration constitue l’un des arguments les plus convaincants en faveur de Forgejo. Ses outils permettent d’importer des dépôts Git, mais aussi une grande partie des données associées : tickets, pull requests, étiquettes, jalons et versions publiées.

Cependant, tout ne se transfère pas nécessairement à l’identique. Certaines fonctionnalités ou métadonnées propres à GitHub peuvent être perdues ou nécessiter des ajustements. Il est donc préférable de vérifier chaque dépôt importé avant de supprimer ou d’abandonner sa version d’origine.

Pour les dépôts privés, il suffit de fournir un jeton d’accès personnel GitHub et de sélectionner les éléments à migrer. Il est également possible de conserver les deux plateformes pendant une période de transition. Forgejo prend en charge les miroirs entrants, qui récupèrent périodiquement les modifications du contenu Git depuis GitHub. Cette synchronisation reste toutefois unidirectionnelle : elle ne réplique pas intégralement les tickets, les pull requests et les autres fonctionnalités de gestion de projet.

Mon usage après l’installation : migration, miroir, CI et sauvegarde

Une fois l’instance en place, j’ai voulu vérifier ce que Forgejo sait faire concrètement. Tous les essais ont été menés sur mon instance locale, avec un compte de test, à partir de dépôts publics.

Migration d’un dépôt GitHub

J’ai importé l’un de mes dépôts publics (environ 5 Mo, avec wiki activé) via l’API de migration, en demandant aussi les tickets, pull requests, étiquettes, jalons et versions. Aucun jeton GitHub n’a été nécessaire pour un dépôt public et l’import s’est terminé en quelques secondes, avec le même identifiant de dernier commit que sur GitHub.

Mon dépôt ne contenant ni ticket ni pull request, je n’ai pas pu vérifier la fidélité de ce volet. Pour un dépôt privé, le jeton personnel reste indispensable.

Dépôt migré depuis GitHub dans Forgejo
Un dépôt GitHub public importé dans Forgejo, avec la même interface de dépôt (instance locale de test).

Un miroir pour garder GitHub en parallèle

J’ai aussi créé un miroir entrant d’un second dépôt, avec une synchronisation toutes les huit heures. Il apparaît dans Forgejo comme un dépôt en lecture seule, ce qui convient pour une période de transition. Comme indiqué plus haut, cette synchronisation ne couvre que le contenu Git.

Dépôt en miroir dans Forgejo
Un dépôt en miroir entrant, synchronisé depuis GitHub (instance locale de test).

CI : un workflow GitHub Actions exécuté tel quel

Pour les Actions, j’ai installé le runner avec brew install forgejo-runner (version 13.2.1), puis l’ai enregistré auprès de mon instance avec le libellé host, ce qui exécute les jobs directement sur le Mac, sans Docker. J’ai ensuite poussé un workflow minimal dans .github/workflows/test.yml, sans dossier .forgejo. Il a été détecté et exécuté avec succès en moins de vingt secondes. Je n’ai testé que ce cas simple, sans action externe de la marketplace GitHub ni mode Docker. Un job lancé directement sur la machine n’est pas isolé, ce que l’on réserve donc à ses propres dépôts.

Workflow Forgejo Actions exécuté avec succès
Un workflow écrit dans .github/workflows, exécuté avec succès par Forgejo Actions (instance locale de test).

Consommation et sauvegarde

Au repos, le processus Forgejo occupait environ 85 Mo de mémoire vive, et 112 Mo après les migrations, les exécutions de CI et une sauvegarde. Le chiffre de 100 Mo annoncé par le projet est donc réaliste. La commande forgejo dump produit en une fois une archive unique (base, dépôts, configuration), qui pesait 5,6 Mo dans mon cas. Il reste à planifier cette sauvegarde et à stocker l’archive ailleurs que sur la même machine.

Ce que je n’ai pas testé

Je n’ai pas exposé l’instance sur Internet (nom de domaine, HTTPS, reverse proxy, SSH), ni migré de dépôt privé ou de tickets réels, ni utilisé les runners Docker. Ces points restent à valider avant un usage réel.

Les avantages : davantage de contrôle et une gouvernance communautaire

Le principal bénéfice de Forgejo est la maîtrise de son infrastructure. Le code, l’historique des tickets et les versions publiées sont stockés sur un support que l’on peut physiquement contrôler, sauvegarder et déplacer. Cette indépendance réduit la dépendance aux changements de conditions de service d’un hébergeur ou aux décisions stratégiques d’une entreprise.

La gouvernance du projet participe également à cette philosophie. Forgejo est géré sous l’égide de Codeberg e.V., une association allemande à but non lucratif qui détient les noms de domaine et les marques. Depuis la version 9.0, le projet est passé de la licence MIT à la GPL v3 ou ultérieure. Il ne propose pas d’édition propriétaire et ne demande pas aux contributeurs de céder leurs droits d’auteur. Cette licence copyleft et cette gouvernance associative visent à garantir que le code publié reste accessible sous des conditions open source.

Publicité

Codeberg exploite par ailleurs sa propre forge publique avec Forgejo. Les personnes qui développent et défendent la plateforme l’utilisent donc au quotidien, ce qui contribue à maintenir les priorités du projet proches des besoins de sa communauté.

À l’usage, l’interface se révèle familière. Les dépôts, pull requests, tickets, étiquettes, jalons, wikis, pages de publication et registres de paquets sont accessibles sans bouleverser les habitudes acquises sur GitHub. Les limites pratiques dépendent principalement de la capacité de son propre matériel : pas besoin de surveiller un quota de stockage ou des minutes de CI facturées par un fournisseur, puisque les ressources sont hébergées sur sa propre infrastructure.

Forgejo Actions reprend la syntaxe YAML de GitHub Actions

Forgejo Actions constitue une autre bonne surprise. Le système reprend la syntaxe YAML de GitHub Actions et sait même rechercher les workflows dans le répertoire. github/workflows lorsqu’aucun dossier. forgejo/workflows n’est présent. Cette compatibilité facilite la migration des pipelines simples de compilation et de test, même si elle n’est pas totale.

Le projet continue d’ailleurs à faire évoluer cette partie. Forgejo 15.0, publiée le 16 avril 2026 à l’occasion de la centième version du projet, apporte notamment les jetons limités à un dépôt, la prise en charge d’OIDC et les runners éphémères.

La stabilité peut également être un argument. La branche Forgejo 15.0 bénéficie d’un support à long terme jusqu’au 15 juillet 2027. Il devient ainsi possible de privilégier une version LTS et de planifier les mises à niveau selon ses propres contraintes, plutôt que de suivre systématiquement le rythme d’évolution d’un fournisseur.

Les inconvénients : maintenance, compatibilité et perte d’audience

Cette indépendance a un prix : en installant Forgejo, on devient aussi responsable de son exploitation. Il faut surveiller les nouvelles versions, appliquer les correctifs de sécurité et suivre les annonces du projet. Une version majeure arrive environ chaque trimestre, tandis que les branches qui ne bénéficient pas d’un support à long terme ont une durée de vie plus courte. Les avertissements de sécurité publiés en amont ne sont utiles que si l’administrateur les consulte régulièrement.

Publicité

Les sauvegardes relèvent également de sa propre responsabilité. En cas de défaillance du disque avant la mise en place d’une stratégie de sauvegarde fiable, il n’existe pas de service client à contacter pour récupérer ses données. Et si le logiciel est gratuit, l’infrastructure ne l’est pas forcément : matériel, électricité, nom de domaine et éventuel hébergement externe représentent des coûts à prendre en compte.

Forgejo Actions demande aussi quelques ajustements. La documentation précise que le système cherche à offrir une expérience familière aux utilisateurs de GitHub Actions, sans garantir une compatibilité complète. Certains workflows devront donc être adaptés, notamment lorsqu’ils reposent sur des actions spécifiques à GitHub.

Autre différence importante : les workflows ne s’exécutent pas directement sur le serveur Forgejo. Ils sont confiés à des runners distincts, ce qui implique d’installer et de maintenir Forgejo Runner. Les compilations consomment alors les ressources de ces machines. Les pipelines qui dépendent d’actions propres à GitHub ou de runners macOS et Windows hébergés par la plateforme peuvent nécessiter une configuration supplémentaire, voire une réécriture partielle.

Principal obstacle : l’effet de réseau

Mais le principal obstacle reste l’effet de réseau. Selon le rapport Converse 2025 de GitHub, la plateforme rassemble désormais plus de 180 millions de développeurs. Même si les dépôts publics de Forgejo peuvent être consultés et clonés sans compte, participer à un projet via les tickets ou les pull requests nécessite généralement une authentification. Pour les développeurs habitués à utiliser leur compte GitHub, cette étape supplémentaire peut décourager certaines contributions.

Les travaux de Forgejo sur la fédération cherchent à réduire cette difficulté, mais ils restent en cours de développement. Ils ne remplacent pas encore l’avantage considérable que représente le fait d’être présent sur une plateforme déjà utilisée par une immense communauté.

La migration peut aussi avoir des conséquences sur les liens existants. Lorsque le projet Organic Maps est passé à Forgejo, son dépôt GitHub a dû être transformé en miroir, ce qui a désactivé son gestionnaire de tickets et son wiki. Des liens présents dans d’autres dépôts, des forums et le wiki d’OpenStreetMap sont alors devenus problématiques. Certains utilisateurs ont également dû se réabonner manuellement aux tickets qu’ils suivaient.

Publicité

Enfin, l’écosystème d’intégrations reste plus restreint. Beaucoup moins d’outils tiers prennent en charge l’API de Forgejo que celle de GitHub, ce qui peut limiter les possibilités d’automatisation et les connexions avec des services externes.

Forgejo : la liberté de gérer ses dépôts, au prix de nouvelles responsabilités

Passer à Forgejo m’a permis de reprendre la main sur mes dépôts, mes données de projet et mon infrastructure. La plateforme offre une forge légère, open source, portée par une organisation à but non lucratif, avec un système de CI/CD que l’on peut exploiter selon ses propres règles.

Mais cette liberté implique aussi de devenir administrateur système et de renoncer à une partie de la visibilité offerte par GitHub. Pour des projets personnels ou des développements secondaires, le compromis peut être particulièrement intéressant. Pour un projet communautaire qui dépend d’une large audience et de contributions externes, la décision mérite en revanche une réflexion plus approfondie.

Publicité
Sujets abordés

Une erreur dans cet article ? Signalez-la : nous la vérifions sous 48 h, et toute correction est datée et visible dans l'article. Voir nos corrections

Décryptage