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.
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.
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.

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.

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.
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.

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.

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.

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.
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.
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.
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.