SSD Nodes Learn Hosting plans →
Guides Matt ConnorPar Matt Connor

Quel serveur Git auto-hébergé choisir ?

Comparez quatre façons d’héberger Git, du dépôt bare en SSH à GitLab, avec cgit, Forgejo et Gitea. Découvrez ce qu’un VPS de 1 Go peut réellement faire.

Quel serveur Git auto-hébergé devriez-vous utiliser

Un serveur Git auto-hébergé ne correspond pas à un seul produit, et la RAM (mémoire vive) de votre VPS détermine la version que vous pouvez installer. Git n’a pas besoin de son propre daemon : un dépôt bare associé à un compte SSH (secure shell) constitue déjà un serveur fonctionnel sur le plus petit serveur que vous pouvez louer. Tout ce qui va au-delà est une application web que vous choisissez d’exécuter à côté, et chaque niveau supplémentaire consomme de la mémoire qu’un petit VPS ne possède peut-être pas. Si vous ne savez toujours pas où s’arrête Git et où commence GitHub, comment Git, GitHub et votre propre serveur Git se distinguent explique cette séparation avant que vous choisissiez une offre.

Il existe quatre niveaux. Un dépôt bare accessible via SSH, sans aucun service supplémentaire en écoute. cgit, une interface web rapide en lecture seule, sans base de données. Forgejo ou Gitea, une forge complète avec des comptes, des issues et des pull requests, dans quelques centaines de mégaoctets. GitLab, qui nécessite un serveur plusieurs fois plus grand que les autres.

Décidez en fonction des opérations dont vous avez besoin, puis comparez la quantité de mémoire requise avec l’offre que vous payez.

Les besoins réels en RAM de chaque option

Seuls deux de ces projets publient une configuration matérielle. Considérez cette valeur comme un minimum, pas comme une garantie, et mesurez votre propre instance une fois qu’elle fonctionne, avec systemd-cgtop ou ps -o rss= -C forgejo.

GraphiqueRAM the projects document, official docs, October 2026
Les données de ce graphique
[
  {
    "label": "Gitea, small team",
    "ram_gb": 1
  },
  {
    "label": "GitLab, memory constrained",
    "ram_gb": 8
  },
  {
    "label": "GitLab, single node baseline",
    "ram_gb": 16
  }
]

Gitea indique que 1 GB de RAM et 2 cœurs CPU suffisent généralement pour les petites équipes et les petits projets, et précise qu’un Raspberry Pi 3 suffit pour les petites charges. GitLab indique 16 GB comme base pour une installation à nœud unique, et 8 GB comme limite basse pour ce que sa propre page appelle un environnement limité en mémoire. La documentation d’installation de Forgejo ne donne aucune valeur de RAM. Forgejo est un fork de Gitea et se comporte de la même manière ; la valeur indiquée par Gitea constitue donc le guide publié le plus proche dont vous disposez.

Sur un VPS doté de 1 GB de RAM, cela signifie que les dépôts bare et cgit fonctionnent avec une marge, car aucun des deux n’exécute de service résident. Forgejo ou Gitea démarrera et pourra servir une petite équipe avec SQLite, mais vous êtes au minimum documenté. Laissez donc PostgreSQL et le runner CI (intégration continue) désactivés sur cette machine. Si l’interface web disparaît sans afficher d’erreur, exécutez sudo dmesg -T | grep -Ei 'oom|out of memory|killed process' et recherchez une ligne telle que Out of memory: Killed process 1181 (forgejo). Cela signifie que l’oom-killer du kernel a arrêté le processus faute de mémoire. GitLab sur une machine dotée de 1 GB de RAM n’est pas un problème de tuning. Il ne fonctionnera pas.

Dépôt nu via SSH

Git n’a pas de daemon réseau à démarrer. git push via SSH exécute git-receive-pack sur l’hôte distant comme un processus Unix ordinaire. Tout compte auquel vous pouvez accéder avec une clé est donc déjà un dépôt Git distant. Créez un compte dédié aux dépôts et conservez les dépôts en dehors de son répertoire personnel. Ainsi, une interface web ajoutée ultérieurement n’aura pas besoin d’accéder à ce répertoire.

sudo adduser --system --shell /bin/bash --gecos 'Git Version Control' \
  --group --disabled-password --home /home/git git
sudo install -d -m 0755 -o git -g git /srv/git
sudo -u git git init --bare /srv/git/project.git

--bare crée un dépôt sans copie de travail, ce qui correspond au contenu conservé sur un serveur. Par défaut, pousser vers la branche extraite d’un dépôt qui possède une copie de travail est refusé avec refusing to update checked out branch: refs/heads/main. C’est l’erreur la plus fréquente à ce niveau.

Donnez maintenant une clé au compte et clonez le dépôt.

sudo -u git install -d -m 700 /home/git/.ssh
sudo -u git tee -a /home/git/.ssh/authorized_keys <<'EOF'
ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere alice@laptop
EOF
sudo -u git chmod 600 /home/git/.ssh/authorized_keys
git remote add origin git@vps.example.com:/srv/git/project.git
git push -u origin main

Un premier push réussi se termine par * [new branch] main -> main. S’il se termine par git@vps.example.com: Permission denied (publickey), l’authentification n’a jamais réussi. Consultez alors le journal du serveur avec sudo journalctl -u ssh -n 20. Une ligne contenant Authentication refused: bad ownership or modes for file /home/git/.ssh/authorized_keys signifie que le propriétaire ou le mode du fichier est incorrect. sshd refuse un fichier de clé dont le propriétaire n’est pas fiable ou dont les permissions autorisent l’écriture par d’autres utilisateurs.

Si le origin du projet pointe déjà vers GitHub, git remote add origin s’arrête avec error: remote origin already exists.. Ajouter ce serveur comme deuxième URL de push sur ce dépôt distant permet alors à un seul git push de mettre les deux dépôts à jour.

Retirez ensuite l’accès au shell de ce compte.

command -v git-shell | sudo tee -a /etc/shells
sudo chsh -s "$(command -v git-shell)" git

git-shell n’accepte que les quelques commandes que Git envoie via SSH. Une connexion interactive s’arrête donc maintenant avec un message au lieu d’afficher une invite :

fatal: Interactive git shell is not enabled.
hint: ~/git-shell-commands should exist and have read and execute access.

C’est tout le serveur. Il n’y a ni base de données ni processus web à mettre à niveau. En contrepartie, vous n’avez aucune des fonctions d’une forge : pas de consultation des dépôts, pas de gestionnaire d’issues, pas de pull requests et pas de permissions par utilisateur. Chaque clé présente dans ce fichier peut lire et écrire dans tous les dépôts appartenant à l’utilisateur git.

Niveau 1 : cgit fournit une interface web sans base de données

cgit est un programme CGI (common gateway interface) écrit en C. Le serveur web l’exécute une fois par requête, il lit directement les dépôts sur le disque et ne conserve aucun état propre. Ubuntu 24.04 l’inclut dans le composant universe.

sudo apt update
sudo apt install -y cgit fcgiwrap nginx
sudo install -d -o www-data -g www-data /var/cache/cgit

Indiquez-lui le répertoire des dépôts dans /etc/cgitrc :

root-title=Git on example.com
css=/cgit.css
logo=/cgit.png
cache-size=1000
cache-root=/var/cache/cgit
snapshots=tar.gz zip
scan-path=/srv/git

scan-path parcourt ce répertoire et répertorie tous les dépôts qu’il trouve. Un nouveau dépôt bare apparaît donc sans configuration supplémentaire. cache-size indique le nombre de pages mises en cache, et la mise en cache reste désactivée tant que cette valeur est nulle. Consultez le contenu que votre paquet a déjà placé dans /etc/cgitrc avant d’ajouter des lignes, car les paquets Debian et Ubuntu fournissent certains paramètres par défaut.

Chaque entrée affiche la première ligne du fichier description du dépôt. Un nouveau dépôt bare apparaît donc sous le nom Unnamed repository; edit this file 'description' to name the repository.. Corrigez cela une fois par dépôt :

echo 'Project X, internal tooling' | sudo -u git tee /srv/git/project.git/description
Le fichier de site nginx et sa vérification
server {
    listen 80;
    server_name git.example.com;
    root /usr/share/cgit;

    try_files $uri @cgit;

    location @cgit {
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME /usr/lib/cgit/cgit.cgi;
        fastcgi_param PATH_INFO $uri;
        fastcgi_param QUERY_STRING $args;
        fastcgi_param HTTP_HOST $server_name;
        fastcgi_pass unix:/run/fcgiwrap.socket;
    }
}
sudo systemctl enable --now fcgiwrap.socket
sudo nginx -t && sudo systemctl reload nginx
systemctl show fcgiwrap.socket -p Listen

root /usr/share/cgit sert cgit.css et cgit.png comme des fichiers statiques, tandis que try_files transmet tout le reste au CGI sur /usr/lib/cgit/cgit.cgi. Une page 502 contenant connect() to unix:/run/fcgiwrap.socket failed (2: No such file or directory) dans /var/log/nginx/error.log indique que l’unité socket n’est pas démarrée ou qu’elle écoute sur un autre chemin. La ligne systemctl show affiche le chemin effectivement utilisé.

Deux limites sont à connaître avant de vous appuyer dessus. cgit est en lecture seule et cette configuration ne comporte aucune authentification. Tout ce qui se trouve sous scan-path est donc public. Conservez les dépôts privés en dehors de ce répertoire ou placez une authentification HTTP basic devant l’ensemble du site. Le CGI s’exécute également avec l’utilisateur du serveur web. Cet utilisateur doit donc pouvoir parcourir /srv/git et lire chaque dépôt. Un répertoire auquel il ne peut pas accéder apparaît comme un index vide plutôt que comme une erreur.

Niveau 2 : Forgejo ou Gitea pour les tickets et les pull requests

Forgejo et Gitea reposent sur le même concept : un binaire Go qui fournit une forge web avec gestion des utilisateurs, des organisations, des tickets (issues), des pull requests, des releases, un registre de paquets et un système CI intégré. Le binaire et SQLite suffisent à l'installation, ce qui leur permet de fonctionner sur du matériel que GitLab ne supporterait pas. Le fichier Compose ci-dessous est celui de la documentation de Forgejo, avec le tag d'image indiqué au 24 octobre 2026.

networks:
  forgejo:
    external: false

services:
  server:
    image: codeberg.org/forgejo/forgejo:17
    container_name: forgejo
    environment:
      - USER_UID=1000
      - USER_GID=1000
    restart: always
    networks:
      - forgejo
    volumes:
      - ./forgejo:/data
      - /etc/localtime:/etc/localtime:ro
    ports:
      - '3000:3000'
      - '222:22'

Ce tag 17 suit la branche v17. Forgejo v17.0.1, publié le 26 octobre 2026, est la version stable actuelle, et Forgejo supporte la v17 jusqu'au 28 janvier 2027. L'ancienne branche v16 a perdu son support le 29 octobre 2026 ; une installation existante utilisant encore le tag 16 doit donc être mise à jour dès maintenant. Passer d'une version majeure à la suivante ultérieurement nécessite une mise à jour manuelle, il est donc plus simple de commencer directement avec la version actuelle.

docker compose up -d
docker compose ps
curl -sI http://127.0.0.1:3000 | head -1

La ligne curl doit afficher une ligne de statut HTTP. Avant de terminer la configuration initiale, il peut s'agir d'une redirection vers /install, ce qui confirme que le service est bien actif. Si le conteneur s'arrête, la cause habituelle est un problème de droits : le répertoire ./forgejo doit appartenir à l'UID (identifiant utilisateur) défini dans USER_UID, sinon le processus ne peut pas écrire dans son répertoire de données. Docker Compose sur un VPS détaille cette structure de fichiers et la règle de propriété des volumes.

Deux réponses sur la page de configuration déterminent si les URLs de clonage fonctionneront. Le port SSH doit correspondre au côté hôte du mappage SSH, qui est 222 dans le fichier Compose ci-dessus, car il mappe le port 222 de l'hôte vers le port 22 du conteneur. Rien n'impose l'utilisation du port 222 : n'importe quel port hôte libre fonctionne, tant que le mappage et cette configuration concordent. Le domaine doit être le nom que les utilisateurs saisiront réellement. En cas d'erreur, chaque page de dépôt affichera une commande de clonage qui échouera pour quiconque la copiera. Ces paramètres se trouvent ensuite dans la section [server] de app.ini, sous les noms SSH_PORT, SSH_DOMAIN et ROOT_URL.

Pour une instance publique, publiez le port web uniquement sur l'adresse de loopback ('127.0.0.1:3000:3000') et placez nginx devant pour gérer le TLS (transport layer security). Gitea s'installe de la même manière à partir de l'image docker.gitea.com/gitea utilisée dans sa documentation, ou en tant que binaire unique avec une unité systemd et un app.ini. Sa version stable actuelle est la v28.4.0, publiée le 15 novembre 2026. Avec la v28.0.0 fin septembre, le projet a abandonné l'ancien préfixe 1. ; la version succédant à la 1.27 est donc la 28, et non la 1.28.

Restez sur SQLite tant que vous le pouvez. Cela limite l'instance à un seul processus et un seul fichier, et permet une reprise après redémarrage sans service supplémentaire à superviser. PostgreSQL devient rentable lorsque plusieurs personnes écrivent simultanément, car SQLite sérialise les écritures et les exécutions CI prolongées écrivent en continu. Les deux projets permettent de migrer une instance existante vers PostgreSQL plus tard, ce n'est donc pas une décision irréversible.

Forgejo ou Gitea : quelles sont les réelles différences

Leur lignée est commune. Gitea est un fork de Gogs créé en 2016. Fin 2022, le contrôle du domaine et de la marque Gitea a été transféré à une société, Gitea Ltd, et plusieurs mainteneurs ont lancé Forgejo avec Codeberg. Forgejo est développé par sa communauté sous l'égide de Codeberg e.V., une association à but non lucratif enregistrée en Allemagne qui détient les domaines du projet, tandis que la gouvernance reste entre les mains des contributeurs de Forgejo. Le projet est passé de la licence MIT à la GPLv3 (GNU general public license version 3) en 2024. Gitea reste sous licence MIT et bénéficie d'un soutien commercial.

Au quotidien, les fonctionnalités sont très proches. Le chemin pour passer de l'un à l'autre ne l'est pas. Forgejo v10.0, sorti en janvier 2025, était la dernière version capable d'importer directement une base de données Gitea, et uniquement à partir de Gitea v1.22 ou antérieure. Gitea étant en v28.4.0 au 16 novembre 2026, une instance Gitea actuelle ne dispose d'aucun mécanisme de migration directe supporté vers Forgejo. Choisissez votre solution avant d'y importer vos données et considérez tout changement ultérieur comme une opération d'exportation et de réimportation.

Une règle simple pour choisir : si la gouvernance est importante pour vous, ou si vous préférez un projet sous une structure à but non lucratif, utilisez Forgejo. Si vous recherchez une base d'installation plus large et une option de support commercial, utilisez Gitea. Les deux sont développés de manière ouverte et publient des mises à jour fréquentes : Forgejo propose une version stable tous les trois mois et une version LTS (long term support) chaque année, avec la v17.0.1 comme version actuelle et la v15.0.11 comme version LTS au 29 octobre 2026. Forgejo supporte la v17 jusqu'au 28 janvier 2027 et la v15 jusqu'au 15 juillet 2027, alors que le support de la v16 a pris fin le 29 octobre 2026 ; consultez donc leur page de releases avant de fixer une version majeure. Si cela ne suffit pas à vous décider, le comparatif complet entre Forgejo et Gitea détaille les différences au niveau des Actions et des registres de paquets, des points techniques à trancher avant que vos données ne rendent une migration coûteuse.

Niveau 3 : ce que GitLab coûte avant même de fonctionner

GitLab CE est une autre catégorie de logiciel. Une instance regroupe plusieurs services qui coopèrent : Puma pour l’application web, Sidekiq pour les tâches en arrière-plan, PostgreSQL, Redis, Gitaly pour l’accès aux dépôts et nginx en frontal. Le paquet Omnibus les installe ensemble, ce qui simplifie l’installation, mais augmente fortement la mémoire minimale nécessaire.

La page des prérequis de GitLab indique 16 GB de RAM et 8 vCPU comme base pour une installation sur un nœud unique, avec 8 GB comme limite basse dans un environnement limité en mémoire. Cette même page vous demande de désactiver le swap, car son utilisation sous charge dégrade fortement l’instance. Il s’agit des valeurs publiées en octobre 2026. Elles ont augmenté au fil des ans. Consultez donc à nouveau cette page avant de dimensionner un serveur.

Ce budget vous apporte de réelles fonctionnalités : un container registry, un package registry, des permissions détaillées et une CI testée à grande échelle. Le centre de conformité ainsi que les journaux d’audit des projets ou des groupes nécessitent une offre GitLab payante. Si personne dans votre équipe ne peut citer une fonctionnalité de cette liste dont elle a besoin ce trimestre, vous payez un VPS plus puissant sans rien obtenir en échange.

Le modèle d’accès SSH : un utilisateur Git et plusieurs clés

Avec OpenSSH système, chaque niveau s’authentifie de la même manière. Il existe un compte Unix nommé git, et toutes les clés publiques sont placées dans le fichier ~/.ssh/authorized_keys de ce compte. L’authentification repose sur la clé. L’autorisation correspond aux options écrites devant la clé sur la même ligne.

Une ligne de clé simple donne à son détenteur tous les droits dont dispose ce compte. Pour un compte qui utilise encore /bin/bash comme shell de connexion, une commande forcée limite l’accès à Git :

restrict,command="git-shell -c \"$SSH_ORIGINAL_COMMAND\"" ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere alice@laptop

restrict, disponible depuis OpenSSH 7.2, désactive en un seul mot la redirection de ports, la redirection de l’agent, X11 et l’allocation d’un PTY (pseudo-terminal). command= remplace la commande demandée par le client par celle que vous indiquez, et Git continue de fonctionner, car le serveur SSH place la commande d’origine du client dans $SSH_ORIGINAL_COMMAND.

Une forge crée ce fichier pour vous. C’est la véritable différence entre le niveau 0 et le niveau 2. Lorsqu’elles utilisent le serveur OpenSSH système, qui est leur configuration par défaut, Forgejo et Gitea réécrivent authorized_keys avec une ligne par clé enregistrée. Chaque ligne contient une commande forcée qui identifie la clé par son identifiant en base de données :

command="/usr/local/bin/forgejo --config=/etc/forgejo/app.ini serv key-3",no-port-forwarding,no-X11-forwarding,no-agent-forwarding,no-pty,no-user-rc,restrict ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAAIexamplekeyhere alice

Cette commande forcée transforme un compte Unix partagé en autorisations propres à chaque utilisateur : key-3 indique à la forge quel utilisateur se connecte, et celle-ci vérifie que cet utilisateur a accès au dépôt avant tout transfert d’objets. Ne modifiez pas manuellement ce fichier sur un serveur géré par une forge, car il est recréé depuis la base de données et votre ligne disparaîtra. Si vous activez le serveur SSH intégré de la forge, ou si vous demandez à OpenSSH de récupérer les clés auprès de la forge via AuthorizedKeysCommand, la forge n’a plus besoin de ce fichier. Dans le second cas, les deux projets recommandent de désactiver sa création. Les deploy keys utilisent le même mécanisme : une deploy key est une clé SSH ordinaire enregistrée pour un seul dépôt, généralement en lecture seule. La vérification est effectuée par la forge plutôt que par sshd.

Deux habitudes comptent davantage que toute la configuration précédente. Utilisez une clé par personne ou par machine, jamais une clé partagée, car la révocation d’une clé partagée oblige à la remplacer pour tout le monde en même temps. Supprimez également les clés le jour du départ d’une personne, car une ancienne clé présente dans ce fichier constitue un accès permanent que personne ne surveille. Une bonne gestion des clés SSH sur un serveur présente les types de clés et les phrases secrètes ; tout cela s’applique ici sans modification. Si le serveur est neuf, les dix premières minutes sur un nouveau VPS est la bonne procédure à suivre avant d’y placer des dépôts.

Puis-je exécuter GitHub Actions sur mon propre serveur Git ?

Vous pouvez exécuter des workflows écrits selon la syntaxe GitHub Actions. Vous ne pouvez pas exécuter GitHub. Forgejo Actions est activé par défaut depuis Forgejo v1.21 et lit les fichiers de workflow dans .forgejo/workflows de chaque dépôt. Gitea Actions fonctionne de la même manière et lit .gitea/workflows. Les deux nécessitent un second programme, le runner, installé et enregistré auprès de votre instance avec un token fourni dans les paramètres d’administration. De nombreuses actions publiées fonctionnent sans modification.

Prévoyez deux conséquences. Avec les labels de conteneur habituels, le runner démarre un conteneur pour chaque job. Il a donc besoin de son propre container engine et d’une réserve de mémoire dédiée. C’est pourquoi il ne doit pas être installé sur le même serveur de 1 GB que la forge. Les deux runners peuvent également exécuter les jobs directement sur l’hôte, au moyen d’un label se terminant par :host sur Forgejo. Cette configuration ne nécessite aucun engine, mais elle ne place aucun conteneur entre le job et cette machine. Le runner exécute tout ce qu’indique un fichier de workflow. La documentation de Forgejo le précise clairement : le runner effectue une exécution de code à distance. Dans la mesure du possible, installez-le sur son propre hôte. À défaut, utilisez au minimum son propre utilisateur non privilégié et un token d’enregistrement limité à un seul dépôt.

Si vos dépôts restent sur GitHub et que vous voulez seulement utiliser la puissance de calcul d’un matériel que vous contrôlez, il s’agit d’une autre configuration, avec d’autres étapes : un runner GitHub Actions auto-hébergé se rattache à un dépôt GitHub et n’a besoin d’aucun de ces éléments. Si vous évaluez encore le coût d’un départ, ce que GitHub fournit réellement distingue l’hébergement Git du réseau qui l’entoure.

Sauvegardes : les dépôts ne représentent que la moitié de l’état

Un dépôt bare est un répertoire : sa copie contient donc tout ce qu’il contient. Un clone miroir depuis une autre machine constitue une vraie sauvegarde et se met à jour sur place :

git clone --mirror git@vps.example.com:/srv/git/project.git
cd project.git && git remote update

Cette commande récupère chaque ref et chaque objet. Elle ne récupère pas les hooks côté serveur ni le fichier description. Si vous utilisez des hooks, conservez donc aussi une copie au niveau des fichiers du répertoire.

Une forge conserve les issues, les pull requests, les utilisateurs, les clés et les permissions dans sa base de données. Une copie des seuls dépôts laisse toutes ces données de côté. Les deux projets fournissent une commande de dump qui écrit la base de données, les dépôts, la configuration et les pièces jointes dans une seule archive :

sudo -u git forgejo dump -c /etc/forgejo/app.ini -f /var/backups/forgejo-dump.zip

Avec Docker, la même commande s’exécute dans le conteneur. Le chemin de configuration dépend de l’image : vérifiez-le avant de saisir la commande :

docker compose exec server ls /data/gitea/conf
docker compose exec -u git server forgejo dump -c /data/gitea/conf/app.ini

Exécutez-la avec l’utilisateur propriétaire des données et écrivez l’archive dans un répertoire où cet utilisateur peut écrire. Copiez ensuite l’archive hors du serveur, car une sauvegarde qui existe uniquement sur la machine sauvegardée n’est pas une sauvegarde. La restauration est l’étape que l’on néglige souvent : décompressez dès maintenant un dump sur une machine de secours afin d’apprendre la procédure dans un moment calme, plutôt que pendant une interruption de service.

Choisir selon le scénario

Une personne avec un ordinateur portable et un VPS, sans besoin de navigation web : des dépôts bare via SSH. Aucun service supplémentaire ne fonctionne et rien n’est à mettre à niveau.

La même configuration, avec en plus le besoin de consulter le code dans un navigateur et de partager des liens vers celui-ci : ajoutez cgit. Toujours pas de base de données ni de service résident.

Une équipe qui relit le code de ses membres et suit les problèmes : Forgejo ou Gitea, avec 2 GB de RAM ou plus. Déplacez le runner CI sur une seconde machine lorsque les jobs deviennent conséquents.

Une organisation qui a besoin d’un registre de conteneurs et de journaux d’audit, avec 16 GB à consacrer au serveur : GitLab. En dessous de cette capacité, ne le déployez pas.

Passer aux trois premiers niveaux coûte peu, car les dépôts sont dans les trois cas de simples répertoires Git sur disque. Commencez par le niveau le plus bas qui répond au besoin. Si vous déterminez quels autres services peuvent justifier l’espace disponible sur le même serveur, la liste restreinte des services qui valent la peine d’être auto-hébergés place un serveur Git aux côtés des autres services qui se disputent cette RAM.

FAQ

Un VPS de 1 GB peut-il faire tourner Forgejo ou Gitea ?

Oui, pour une petite équipe, avec SQLite et sans autre charge importante sur la machine. La documentation de Gitea indique que 1 GB de RAM et 2 coeurs de processeur suffisent généralement pour les petites équipes et les petits projets, et Forgejo est un fork de Gitea avec des besoins comparables. N’ajoutez pas PostgreSQL ni un runner CI sur cette machine. Si le service disparaît sans erreur dans son propre journal, exécutez sudo dmesg -T | grep -Ei 'oom|out of memory|killed process' : une ligne qui nomme le processus tué signifie que l’out-of-memory killer du kernel l’a arrêté. La solution consiste alors à choisir une offre plus puissante, pas à modifier un flag de réglage.

Quelle est la différence entre Forgejo et Gitea ?

Ils partagent un historique de code et la plupart de leurs fonctionnalités. Gitea a été forké de Gogs en 2016, puis Forgejo a été forké de Gitea fin 2022, après le transfert du contrôle de la marque Gitea à une entreprise. Forgejo est développé par sa communauté sous l’égide de Codeberg e.V., une organisation à but non lucratif en Allemagne, et publié sous GPLv3 ; Gitea reste sous licence MIT avec un soutien commercial. La différence pratique concerne le chemin de migration. Forgejo v10.0, publié en janvier 2025, a été la dernière version à pouvoir utiliser directement une base de données Gitea, et uniquement à partir de Gitea v1.22 ou d’une version antérieure. Une instance Gitea récente ne peut donc pas être convertie sur place avec une procédure prise en charge.

Puis-je exécuter des workflows GitHub Actions sur un serveur Git auto-hébergé ?

Forgejo Actions et Gitea Actions exécutent tous deux des workflows écrits avec la syntaxe YAML de GitHub Actions, lus depuis .forgejo/workflows et .gitea/workflows. Installez un programme runner séparé et enregistrez-le auprès de votre instance. De nombreuses actions publiées fonctionnent sans modification. Le runner exécute du code arbitraire provenant de vos dépôts et, avec les labels de conteneur habituels, démarre un conteneur par job. Donnez-lui donc son propre hôte ou, au minimum, son propre utilisateur non privilégié. Ne l’installez pas sur un serveur de 1 GB qui exécute déjà la forge.

Comment sauvegarder un serveur Git auto-hébergé ?

Pour les dépôts bare, git clone --mirror exécuté depuis une autre machine copie chaque ref et chaque objet, et git remote update exécuté dans ce mirror l’actualise. Avec Forgejo ou Gitea, les dépôts ne représentent qu’une partie de l’état, car les tickets, les pull requests, les utilisateurs et les clés sont stockés dans la base de données. Utilisez le dump intégré, sudo -u git forgejo dump -c /etc/forgejo/app.ini, ou exécutez la même commande dans le conteneur pour une installation Docker. Copiez l’archive hors du serveur et restaurez-la une fois sur une machine de secours afin de vérifier que la procédure fonctionne.

Cet article vous a-t-il été utile ?