Forgejo est une forge logicielle self-hosted, légère et 100 % libre, conçue pour héberger des dépôts Git avec gestion de projet, CI/CD et registre de paquets intégrés. Fork communautaire de Gitea créé en 2022, Forgejo est porté par une communauté indépendante sous l'égide de Codeberg e.V., une association à but non lucratif allemande. Avec un binaire unique consommant moins de 200 Mo de RAM, c'est l'une des forges les plus légères du marché, tout en offrant un périmètre fonctionnel comparable à GitHub.
Ce que vous allez apprendre
Section intitulée « Ce que vous allez apprendre »- Comprendre ce qu'est Forgejo : son origine, sa gouvernance communautaire et sa licence
- Connaître les fonctionnalités principales : dépôts Git, CI/CD, registre de paquets, fédération
- Identifier la stack technique : un binaire Go unique, bases de données supportées, composants
- Comparer Forgejo à Gitea et aux autres forges : différences concrètes de gouvernance et de fonctionnalités
- Évaluer si Forgejo convient à votre contexte (ressources, conformité, philosophie)
Origine et gouvernance
Section intitulée « Origine et gouvernance »Forgejo est né en octobre 2022 après que Gitea Ltd. a été créée en tant qu'entreprise commerciale, suscitant des inquiétudes dans la communauté open-source. Un groupe de contributeurs a forké Gitea pour garantir que le projet reste libre et gouverné collectivement.
Le projet est placé sous la tutelle de Codeberg e.V., une association à but non lucratif enregistrée à Berlin. Codeberg détient les domaines et fournit l'infrastructure, mais la gouvernance technique reste indépendante et définie collectivement par les contributeurs.
| Aspect | Détail |
|---|---|
| Création | Octobre 2022 (fork de Gitea) |
| Organisation | Codeberg e.V. (association à but non lucratif, Berlin) |
| Gouvernance | Collective, définie par les contributeurs |
| Licence | GPL v3+ (depuis v9.0 ; MIT pour les versions antérieures) |
| Code source | codeberg.org/forgejo/forgejo |
| Financement | Bénévolat, dons (Liberapay), subventions, contrats de service |
Stack technologique
Section intitulée « Stack technologique »Forgejo est un binaire unique écrit en Go qui embarque tous les composants nécessaires.
| Composant | Technologie | Rôle |
|---|---|---|
| Serveur web | Go (Chi) | Interface web, API REST, serveur Git HTTP/SSH |
| ORM | XORM | Abstraction base de données |
| Base de données | SQLite, PostgreSQL, MySQL/MariaDB | Stockage des métadonnées (projets, utilisateurs, issues) |
| Indexeur de code | Bleve (intégré) ou Meilisearch | Recherche full-text dans le code et les issues |
| File de messages | En mémoire ou Redis | Gestion des tâches asynchrones (webhooks, emails) |
| UI | Vue 3, Fomantic UI | Interface utilisateur web |
| CI/CD | Forgejo Runner (Go) | Exécution des workflows Forgejo Actions |
Fonctionnalités principales
Section intitulée « Fonctionnalités principales »Hébergement Git et revue de code
Section intitulée « Hébergement Git et revue de code »- Dépôts Git avec interface web, éditeur en ligne et visualisation de diff
- Pull requests avec revue de code en ligne, discussions et approbations
- Branches protégées avec règles de merge configurables
- Miroir de dépôts (pull et push) depuis/vers d'autres forges
- Signature GPG/SSH des commits
CI/CD, Forgejo Actions
Section intitulée « CI/CD, Forgejo Actions »- Workflows YAML compatibles avec la syntaxe GitHub Actions
- Forgejo Runner : exécuteur léger en Go (shell, Docker, LXC)
- Réutilisation d'Actions existantes : la plupart des Actions GitHub fonctionnent directement
- Téléchargement d'Actions depuis n'importe quel dépôt Git (pas uniquement GitHub)
Gestion de projet
Section intitulée « Gestion de projet »- Issues avec labels, milestones, assignations et suivi de temps
- Tableaux Kanban (boards de projet)
- Wiki intégré par dépôt
- Webhooks vers Slack, Discord, Matrix, Mattermost et endpoints personnalisés
Registre de paquets
Section intitulée « Registre de paquets »- Container Registry (images OCI/Docker)
- Package Registry compatible : npm, PyPI, Maven, NuGet, Cargo, Composer, Conda, Helm, RubyGems, Conan, Pub, Vagrant et plus de 20 formats
Fédération (expérimentale)
Section intitulée « Fédération (expérimentale) »- ActivityPub / ForgeFed : Forgejo travaille activement sur la fédération entre instances
- Objectif : permettre à des forges indépendantes de collaborer (suivre des utilisateurs distants, interagir avec des dépôts d'autres instances)
- Fonctionnalité expérimentale, des changements incompatibles sont possibles
Méthodes d'installation
Section intitulée « Méthodes d'installation »| Méthode | Description | Recommandée pour |
|---|---|---|
| Binaire | Téléchargement direct depuis forgejo.org/releases | Serveurs Linux, contrôle maximal |
| Container OCI | codeberg.org/forgejo/-/packages/container/forgejo | Docker, Podman, Kubernetes |
| Packages Debian/RPM | Via les dépôts communautaires | Distributions Linux standard |
Forgejo vs Gitea : quelles différences ?
Section intitulée « Forgejo vs Gitea : quelles différences ? »Forgejo et Gitea partagent la même base de code historique, mais les projets divergent de plus en plus.
| Aspect | Forgejo | Gitea |
|---|---|---|
| Gouvernance | Communauté (Codeberg e.V.) | Entreprise (Gitea Ltd. / CommitGo Inc.) |
| Licence | GPL v3+ (depuis v9.0) | MIT |
| Offre commerciale | Aucune (services professionnels communautaires) | Gitea Cloud + Gitea Enterprise |
| Support Windows | Abandonné | Maintenu |
| Fédération ActivityPub | En développement actif | Non prioritaire |
| Certification SOC 2 | Non | Oui (CommitGo) |
| API | Compatible Gitea (divergences mineures) | API de référence |
| Migration Gitea → Forgejo | Supportée officiellement | — |
Forgejo vs GitLab CE
Section intitulée « Forgejo vs GitLab CE »| Critère | Forgejo | GitLab CE |
|---|---|---|
| RAM minimum | ~200 Mo | ~4 Go |
| CPU minimum | 1 vCPU | 2 vCPU |
| Installation | 1 binaire | Package Omnibus (~1 Go) |
| CI/CD | Forgejo Actions (compatible GitHub Actions) | GitLab CI (syntaxe propriétaire) |
| SAST/DAST | Non intégré | Intégré (Ultimate) |
| Registre de paquets | 20+ formats | 10+ formats |
| Gestion de portefeuille | Non | Epics, Milestones (Premium+) |
| Complexité opérationnelle | Faible | Élevée |
À retenir
Section intitulée « À retenir »- Forgejo est une forge Git self-hosted légère, 100 % libre (GPL v3+), portée par une communauté indépendante sous Codeberg e.V.
- Fork de Gitea depuis 2022, motivé par la volonté de préserver une gouvernance communautaire face à la commercialisation de Gitea
- Un binaire unique en Go qui embarque serveur web, Git, base de données (SQLite possible) et indexeur
- Empreinte minimale : ~200 Mo RAM, fonctionne sur un Raspberry Pi
- Forgejo Actions pour le CI/CD, compatible avec la syntaxe GitHub Actions
- Registre de paquets intégré (Docker, npm, PyPI, Maven et 20+ formats)
- La fédération (ActivityPub/ForgeFed) est la fonctionnalité phare en développement, absente chez Gitea et GitLab
- Migration depuis Gitea supportée officiellement (remplacement du binaire)
Prochaines étapes
Section intitulée « Prochaines étapes » Installer Forgejo sur Linux Installation binaire sur Ubuntu : service systemd, configuration web, premier dépôt.
Configuration initiale Sécuriser app.ini, désactiver les inscriptions, configurer SSH et le mailer.
Comparer les plateformes Git GitHub, GitLab, Bitbucket, Gitea, Forgejo, critères de choix et positionnement.