Gitea : héberger sa forge Git self-hosted en Go

Gitea est un serveur Git complet écrit en Go : un binaire unique, moins de 200 Mo de RAM et une interface web claire. Il convient à qui veut héberger sa propre forge Git, légère et autonome, sans dépendre de GitHub ni opérer un GitLab complexe. Cette page présente le projet, le compare à ses alternatives et oriente vers les guides d'installation, de configuration, de sauvegarde et de mise à jour.

Gitea est né en 2016 comme fork de Gogs et est développé aujourd'hui par CommitGo Inc. (anciennement Gitea Ltd). Le projet propose trois éditions : Open Source (gratuite, licence MIT), Enterprise (support commercial) et Cloud (SaaS hébergé). L'édition open source couvre ce qu'une équipe attend d'une forge moderne : dépôts Git, issues, pull requests, webhooks, Gitea Actions (CI/CD compatible GitHub Actions) et registre de paquets.

Les guides de cette section ont été rejoués sur Gitea 1.26.4 (installation) et 1.27.3 (sauvegarde). Les versions montent vite : relevez la dernière version stable sur la page des releases du projet avant d'installer. Au 16 octobre 2026, c'est la 28.1.0 : le projet a abandonné la numérotation 1.x après la 1.27.3 et publie désormais des versions 28.x. Les numéros de version cités dans les guides sont ceux des essais : sur une 28.x, relisez les notes de version avant de rejouer une procédure.

Gitea et Forgejo

Forgejo est un fork communautaire de Gitea, né en 2022. Les deux projets partagent une origine commune, mais Gitea 28 diverge désormais de Forgejo : ne supposez pas qu'une procédure ou une API de l'un vaut pour l'autre sans la vérifier. Choisissez Gitea si vous préférez le projet d'origine, Forgejo si vous valorisez la gouvernance communautaire. Les procédures d'installation et de maintenance restent proches dans leur principe : la formation Administrer une forge Git détaille celles de Forgejo.

Ce que vous allez apprendre

• Situer Gitea face à Forgejo, GitLab CE et GitHub
• Repérer les composants d'une installation standard : binaire, configuration, données
• Choisir le guide de la section qui correspond à votre besoin : installer, configurer, sauvegarder, mettre à jour

Quels guides pour héberger Gitea ?

Cette section suit le cycle de vie d'un serveur Gitea, de la découverte à la mise à jour. Les cinq guides ci-dessous se lisent dans cet ordre quand on part de zéro, ou séparément quand on exploite déjà une instance.

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

Installer Gitea sur Ubuntu Installation binaire sur Ubuntu 24.04 : vérification SHA256, service systemd, création de l'admin.

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

Sauvegarder et restaurer Backup avec gitea dump, automatisation cron, procédure de restauration complète.

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

Gitea vs les alternatives

Le tableau compare Gitea à trois alternatives sur les critères qui comptent pour un exploitant : ressources nécessaires, CI/CD intégrée, gouvernance du projet, licence et complexité d'exploitation. Les écarts de RAM et de complexité expliquent la place de Gitea et de Forgejo dans les homelabs et les petites équipes. La présentation de Gitea détaille chaque critère.

Critère	Gitea	Forgejo	GitLab CE	GitHub
RAM minimum	~200 Mo	~200 Mo	~4 Go	SaaS
CPU minimum	1 vCPU	1 vCPU	2 vCPU	SaaS
CI/CD intégré	Gitea Actions	Forgejo Actions	GitLab CI	GitHub Actions
Rapport à GitHub Actions	Syntaxe quasi compatible	Syntaxe proche, non compatible par conception	Aucun (GitLab CI)	Natif
Registre de paquets	Oui	Oui	Oui	Oui
Gouvernance	CommitGo Inc.	Communauté (Codeberg e.V.)	GitLab Inc.	Microsoft
Licence	MIT	GPL v3+	MIT + EE propriétaire	Propriétaire
Complexité opérationnelle	Faible	Faible	Élevée	Sans objet

Glissez pour voir

Pour comparer toutes les plateformes, y compris Bitbucket, voir Plateformes Git : GitHub, GitLab, Gitea et alternatives.

Architecture d'une installation standard

Un déploiement Gitea minimal repose sur trois composants : le binaire, le fichier de configuration et les données. Le service systemd, fourni par le projet, gère le démarrage automatique et le redémarrage en cas d'erreur.

• Le binaire gitea, exécutable statique unique, placé dans /usr/local/bin/
• Le fichier de configuration app.ini, dans /etc/gitea/, avec toutes les options du serveur
• Les données, dans /var/lib/gitea/ : dépôts Git, base de données SQLite, LFS, paquets

L'arborescence ci-dessous montre où chaque élément vit sur le disque. Elle sert de repère pour les guides de sauvegarde et de mise à jour, qui visent ces mêmes chemins.

/usr/local/bin/gitea          ← binaire
/etc/gitea/app.ini            ← configuration
/var/lib/gitea/
  data/gitea.db               ← base de données (SQLite par défaut)
  data/gitea-repositories/    ← dépôts Git bare
  data/lfs/                   ← fichiers Git LFS
  data/packages/              ← registre de paquets
  log/                        ← journaux applicatifs
  backups/                    ← archives gitea dump

À retenir

• Gitea s'installe via un binaire statique unique, Docker n'est pas obligatoire
• La configuration complète tient dans un seul fichier, app.ini
• gitea dump sauvegarde l'intégralité en une commande (service actif possible)
• L'upgrade se fait par remplacement du binaire, sans migration de base de données complexe
• L'API REST est complète et compatible avec de nombreux outils GitOps
• Les versions montent vite : relevez la dernière stable avant d'installer

Prochaines étapes

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

Gitea ou Forgejo Le fork communautaire de Gitea : sa formation d'administration, de l'installation à la mise à jour.

Présentation de GitLab L'alternative complète quand il faut une CI/CD et une sécurité intégrées.

×

📖 Voir la documentation →