Forgejo : héberger sa forge Git en self-managed

Forgejo héberge votre propre forge Git sans les contraintes commerciales de GitLab EE ni la complexité d'une infrastructure lourde : un serveur Git complet, léger, open-source, que vous maîtrisez entièrement.

Forgejo (prononcé "for-JEH-jo") est un fork communautaire de Gitea, né en 2022 pour garantir que le logiciel reste libre et gouverné par sa communauté. Écrit en Go, il se distribue sous licence GPL v3+ et offre les mêmes fonctionnalités qu'un GitHub ou un GitLab léger : dépôts Git, issues, pull requests, CI/CD (Forgejo Actions), registre de paquets, le tout dans un binaire unique qui consomme aussi peu que 200 Mo de RAM.

Forgejo est hébergé par Codeberg e.V. (association allemande à but non lucratif). Les décisions sont prises collectivement par les contributeurs, sans entité commerciale. C'est l'un des rares serveurs Git à implémenter la fédération ActivityPub (ForgeFed), permettant d'interagir entre instances.

Ce que vous trouverez dans cette section

Présentation de Forgejo Origine, gouvernance, fonctionnalités, comparatifs et positionnement face à Gitea et GitLab.

Installer Forgejo sur Ubuntu Installation binaire complète sur Ubuntu 24.04 : binaire, systemd, configuration web initiale.

Configuration initiale Sécuriser app.ini, désactiver les inscriptions, configurer SSH et le mailer.

Sauvegarder et restaurer Backup avec forgejo dump, automatisation cron, procédure de restauration testée.

Mettre à jour Forgejo Procédure d'upgrade : vidage des queues, backup, remplacement binaire, doctor check.

Forgejo vs les alternatives

Critère	Forgejo	GitLab CE	GitHub
RAM minimum	~200 Mo	~4 Go	SaaS
CPU minimum	1 vCPU	2 vCPU	SaaS
CI/CD intégré	Oui (Forgejo Actions)	Oui (GitLab CI)	Oui (GitHub Actions)
Registre Docker	Oui	Oui	Oui
Gouvernance	Communauté (Codeberg e.V.)	GitLab Inc.	Microsoft
Licence	GPL v3+	MIT (CE) + EE propriétaire	Propriétaire
Complexité opérationnelle	Faible	Élevée	Sans objet

Architecture de Forgejo

Forgejo est un binaire unique qui intègre tout :

Serveur web (Go, port 3000 par défaut)
Accès SSH Git (via le port 22 ou un port dédié)
Base de données (SQLite pour les petites instances, PostgreSQL ou MySQL pour la production)
File de messages (en mémoire ou Redis pour les grandes instances)
Indexeur de code (Bleve ou Meilisearch)

Prérequis pour ce guide

Un serveur Ubuntu 24.04 LTS (ou Debian 12)
Accès sudo
Connexion internet pour télécharger le binaire
Un nom de domaine ou une IP statique

À retenir

Forgejo est un fork communautaire de Gitea, gouverné par Codeberg e.V. sous licence GPL v3+
Très léger : 200 Mo de RAM pour une instance personnelle, 2 Go pour une petite équipe
La version stable actuelle est v15.0.0 (avril 2026, LTS supportée jusqu'en juillet 2027)
La procédure d'installation standard utilise un binaire unique + systemd
forgejo dump prend en charge le backup complet (DB + repositories + config)

FAQ : Forgejo

Peut-on déployer Forgejo avec Docker Compose ?

Oui. Forgejo publie une image Docker officielle (codeberg.org/forgejo/forgejo) et se déploie très bien avec Docker Compose, en montant un volume persistant pour les données et la base. L'installation binaire + systemd reste l'alternative la plus légère.

Docker Compose ou binaire ?

Forgejo propose une image Docker officielle : codeberg.org/forgejo/forgejo. Un déploiement Docker Compose est pleinement supporté et pratique pour isoler le service.Les points clés d'un compose.yml Forgejo :

Élément	Rôle
Volume `/data`	Persistance des dépôts, base SQLite et configuration
Port `3000`	Interface web
Port `22` / `2222`	Accès SSH Git
`USER_UID` / `USER_GID`	Aligner les droits sur l'hôte

Pour une instance minimale et économe en ressources, l'installation binaire + systemd reste l'option la plus légère.

Forgejo intègre-t-il un CI/CD ?

Oui, via Forgejo Actions, compatible avec la syntaxe des workflows GitHub Actions. Il faut déployer un Forgejo Runner séparé qui exécute les jobs ; les workflows se placent dans .forgejo/workflows/.

Quelle configuration matérielle faut-il pour Forgejo ?

Forgejo est très léger : environ 200 Mo de RAM et 1 vCPU suffisent pour une instance personnelle. Comptez environ 2 Go de RAM pour une petite équipe avec une base PostgreSQL.

Ressources minimales

Forgejo est conçu pour être frugal :

Usage	RAM	CPU	Base de données
Instance personnelle	~200 Mo	1 vCPU	SQLite
Petite équipe	~2 Go	2 vCPU	PostgreSQL

C'est l'un de ses principaux atouts face à GitLab CE, qui réclame au minimum 4 Go de RAM. Forgejo tourne donc confortablement sur un petit VPS.

Quelle différence entre Forgejo et Gitea ?

Forgejo est un fork communautaire de Gitea créé en 2022. Même base technique, mais une gouvernance 100% communautaire (Codeberg e.V.), la garantie de rester libre sous GPL v3+, et des fonctionnalités propres comme la fédération ActivityPub.

Forgejo vs Gitea

Forgejo est un fork communautaire de Gitea lancé en 2022, après la reprise de Gitea par une entité commerciale.

Critère	Forgejo	Gitea
Gouvernance	Communautaire (Codeberg e.V.)	Société commerciale
Licence	GPL v3+	MIT
Fédération	ActivityPub (ForgeFed)	Non
Éditions payantes	Aucune	Cloud / Enterprise

Les deux partagent encore une large base de code, mais Forgejo se positionne comme la garantie d'un logiciel 100% libre et communautaire.

Comment sauvegarder une instance Forgejo ?

Avec la commande forgejo dump, qui archive en un seul fichier la base de données, les dépôts Git et la configuration. À automatiser via cron, et à tester régulièrement en restauration.

La commande forgejo dump

Forgejo fournit une commande dédiée qui produit une archive complète :

sudo -u git forgejo dump -c /etc/forgejo/app.ini

Elle regroupe la base de données, les dépôts Git et la configuration dans un seul fichier. À automatiser via cron et à tester en restauration. La procédure détaillée est dans le guide Sauvegarder et restaurer.

Prochaines étapes

Installer Forgejo Démarrez avec l'installation binaire sur Ubuntu 24.04.

Voir aussi : Gitea Le projet d'origine, avec des éditions Enterprise et Cloud.