Ce que nous allons monter
Avant de taper la première commande, regardons la cible. Pas seulement ce que nous installons aujourd’hui, mais ce que cette machine hébergera à la fin de la formation — c’est ce qui doit dicter le dimensionnement.
┌─────────────────────────────────┐
Vos postes ────────▶ │ Reverse proxy (HTTPS) │
Vos serveurs └─────────────┬───────────────────┘
Vos GPO │
┌─────────────▼───────────────────┐
│ Forgejo │
│ · dépôts Git │
│ · interface web │
│ · registre de conteneurs (§10)│
│ · pages publiées (§11)│
└─────────────┬───────────────────┘
│
┌─────────────▼───────────────────┐
│ PostgreSQL │
└─────────────────────────────────┘
┌─────────────────────────────────┐
│ Runner (§9) │
│ exécute vos workflows │
└─────────────────────────────────┘
Aujourd’hui, en section 2, nous déployons les deux premiers conteneurs. Le runner arrivera en section 9, le registre s’activera en section 10.
Ce point mérite d’être souligné maintenant : Forgejo en lui-même consomme très peu. Ce sont le runner et le registre qui pèsent. Un dimensionnement calculé sur la seule forge vous mettra en difficulté vers la section 9.
L’hôte
Une VM Linux avec Docker et Docker Compose. C’est tout.
La distribution importe peu : Debian, Ubuntu Server, Rocky Linux, Alpine font parfaitement l’affaire. Prenez celle que vous savez administrer et sauvegarder — c’est le critère qui compte, pas les performances.
Pour les besoins de cette formation, je pars sur Debian 13 avec Docker CE. Si l’installation de Docker ne vous est pas familière, la formation Docker pour les débutants couvre exactement ce dont vous avez besoin ici, et nous réutiliserons plusieurs de ses notions : réseaux, volumes, variables d’environnement, reverse proxy.
Une VM dédiée ou mutualisée ? Techniquement, Forgejo cohabite sans problème avec vos autres conteneurs. Mais souvenez-vous de la leçon 1.5 : à la fin de cette formation, cette forge distribuera des scripts à vos postes et alimentera vos serveurs en images. Ce sera un service de production. Si vous en avez la possibilité, une VM dédiée simplifie la sauvegarde, la restauration et les redémarrages.
Le choix de la base de données
Forgejo accepte trois moteurs, et ce choix se fait maintenant : en changer plus tard demande une migration.
SQLite — aucune base à installer, tout tient dans un fichier. C’est le moteur le plus simple à exploiter, sans maintenance, et la documentation officielle de Forgejo le recommande pour les instances à activité faible ou modérée. Il faut lui reconnaître cette qualité : sur une petite forge, SQLite peut tenir des années sans poser le moindre problème.
Ses limites apparaissent avec la concurrence : plusieurs utilisateurs simultanés, des workflows qui écrivent pendant qu’on navigue dans l’interface, un registre d’images sollicité.
MySQL / MariaDB — pleinement supporté. Le bon choix si vous avez déjà une instance en production que vous savez sauvegarder.
PostgreSQL — c’est ce que nous utiliserons dans cette formation.
Pourquoi PostgreSQL malgré la recommandation officielle ?
Le désaccord n’en est pas vraiment un : il tient au périmètre. La recommandation officielle vise une forge classique — des dépôts, des tickets, quelques utilisateurs. Or ce que nous allons construire dépasse ce cadre : workflows d’intégration continue, registre de conteneurs sollicité par plusieurs serveurs, outils tiers qui interrogent la forge en permanence en section 12. C’est précisément le profil de charge où la documentation elle-même oriente vers MySQL ou PostgreSQL.
À cela s’ajoute un argument pratique, et c’est celui qui emporte ma décision : la migration d’un moteur à l’autre n’est pas triviale — la documentation le signale explicitement — et vous la découvririez au pire moment, quand la forge sera déjà en production avec ses GPO et ses images branchées dessus.
Le surcoût d’un conteneur PostgreSQL est faible ; celui d’une migration subie ne l’est pas.
Si vous voulez simplement essayer Forgejo une heure, SQLite est parfait, et vous n’aurez qu’un seul conteneur à lancer. Sachez juste que le dépôt que vous créerez ce jour-là ne se transposera pas sans effort vers votre installation définitive.
Dimensionnement
Voici des ordres de grandeur, à ajuster selon votre contexte.
| Périmètre | vCPU | RAM | Disque |
|---|---|---|---|
| Forgejo + PostgreSQL seuls (sections 2 à 8) | 2 | 2 Go | 20 Go |
| + runner et registre (sections 9 à 14) | 2 | 4 Go | 40 Go minimum |
| Usage réel en PME, une dizaine d’utilisateurs | 2-4 | 4-8 Go | 60-100 Go |
Trois commentaires sur ces chiffres.
Le processeur n’est presque jamais le problème. Servir des pages et des dépôts Git coûte très peu. Les pics viennent des workflows — une construction d’image Docker sature un cœur pendant deux minutes. Si vos builds sont lents, c’est le moment d’ajouter un vCPU, pas avant.
La mémoire compte surtout à cause du runner. Forgejo tourne confortablement dans quelques centaines de mégaoctets. PostgreSQL en demande peu sur ce volume. Mais un workflow qui construit une image lance des conteneurs supplémentaires, avec des compilations et des téléchargements. C’est là que 2 Go deviennent insuffisants.
Le disque est le vrai sujet. Et c’est celui qu’on sous-estime systématiquement.
Le disque : ce qui grossit, et à quelle vitesse
Vos dépôts Git ne poseront aucun problème. Du texte, compressé, avec un historique : un référentiel de plusieurs centaines de scripts pèse quelques dizaines de mégaoctets. Vous pouvez l’oublier.
Ce qui grossit, c’est le registre d’images de conteneurs.
Une image PostgreSQL pèse quelques centaines de mégaoctets. Une image applicative maison, autant. Et vous n’en conserverez pas une seule version : à chaque construction, une nouvelle. Multipliez par le nombre d’images, par le nombre de versions conservées, et vous atteignez rapidement plusieurs dizaines de gigaoctets — pour une infrastructure modeste.
C’est pour cette raison que la section 10 comporte une leçon entière sur la rétention : combien de versions garder, et comment purger le reste automatiquement. Retenez dès maintenant que sans politique de rétention, un registre grossit indéfiniment.
Les journaux d’exécution des workflows suivent la même logique, dans des proportions moindres.
Un dernier consommateur, souvent découvert trop tard : l’indexeur de code. Désactivé par défaut, il permet la recherche de texte à travers l’ensemble des dépôts plutôt que dans un seul. La fonction est appréciable — mais la documentation officielle précise qu’elle consomme environ six fois la taille des dépôts indexés. Si vous l’activez un jour, faites-le en connaissance de cause.
Conseil pratique : prévoyez le disque de la forge sur un volume que vous pouvez agrandir à chaud. Vous le ferez au moins une fois.
Le stockage : où vivent les données
C’est la question à trancher avant le déploiement, parce qu’elle conditionne votre sauvegarde.
Deux emplacements contiennent tout ce qui compte.
Le dossier de données de Forgejo (/data dans le conteneur) rassemble :
- les dépôts Git eux-mêmes ;
- le fichier de configuration de l’application ;
- les avatars, pièces jointes et fichiers téléversés ;
- le contenu du registre de paquets et de conteneurs ;
- les journaux et les clés SSH du serveur.
Petite curiosité historique : à l’intérieur de /data, le sous-dossier de configuration a conservé le nom gitea, héritage du projet dont Forgejo est issu. Ne soyez pas surpris de trouver un chemin de ce type au moment de la sauvegarde.
Le dossier de données de PostgreSQL, qui contient les comptes, les permissions, les tickets, les pull requests, les définitions de workflows et l’ensemble des métadonnées.
Ces deux emplacements doivent être sauvegardés ensemble et restaurés ensemble. Une sauvegarde de l’un sans l’autre est inexploitable : vous auriez les dépôts sans les droits, ou les droits sans les dépôts.
Montage lié ou volume nommé ?
Docker propose les deux. Le compose que nous détaillerons en 2.2 utilise des montages liés — des dossiers du système hôte montés dans les conteneurs.
C’est un choix que je recommande ici, pour une raison très pragmatique : vos données sont visibles dans un chemin que vous connaissez, que votre outil de sauvegarde parcourt déjà, et que vous pouvez inspecter sans passer par des commandes Docker. Pour un administrateur système, c’est un avantage réel sur un service de production.
La contrepartie s’appelle les permissions, et c’est le piège classique.
Le piège des permissions
Vous verrez dans le compose deux variables :
- USER_UID=1000
- USER_GID=1000
Elles indiquent au conteneur sous quel identifiant utilisateur travailler. Le dossier hôte monté doit appartenir à ce même identifiant, sinon Forgejo ne pourra pas écrire et refusera de démarrer — avec un message pas toujours explicite.
Si vous rencontrez des erreurs de permission au premier démarrage, c’est presque toujours de là qu’elles viennent. Vérifiez le propriétaire du dossier de données côté hôte, et alignez-le avec ces valeurs.
Nous y reviendrons concrètement en 2.2.
Le nom : la décision la plus engageante
Voici le point que je vous demande de traiter avec le plus de sérieux, parce que c’est le seul de cette leçon qui soit réellement difficile à corriger.
Choisissez maintenant, définitivement, le nom sous lequel votre forge sera jointe : forge.nordika.local, git.nordika.fr, peu importe — mais choisissez-le pour de bon.
Pourquoi tant d’insistance ? Parce qu’à la fin de cette formation, ce nom sera inscrit :
- dans l’URL de clonage de chacun de vos dépôts, sur chaque poste ;
- dans le lanceur de vos stratégies de groupe (section 7) ;
- dans vos scripts d’amorçage de serveurs Linux (section 8) ;
- dans les références d’images de tous vos fichiers
docker-compose.yml(section 10) ; - dans la configuration de vos outils qui lisent la forge (section 12).
Le changer plus tard, ce n’est pas modifier un enregistrement DNS : c’est reprendre tout ce qui précède.
Trois conseils sur ce choix :
Un nom court et neutre. forge ou git plutôt que forgejo — vous pourriez changer de produit un jour, comme je l’ai fait moi-même.
Un domaine que vous maîtrisez et pour lequel vous pouvez émettre un certificat.
Interne uniquement, sauf besoin explicite. Souvenez-vous de la leçon 1.2 : rien ne vous oblige à exposer cette machine sur Internet, et beaucoup vous en dissuade. Nous verrons en 2.9 ce que « dépôt public » signifie exactement sur une instance interne — et pourquoi cela change tout pour le pattern des GPO.
La question du SSH
Deux protocoles permettent de dialoguer avec la forge : HTTPS, via le reverse proxy, et SSH, sur le port 22.
Le HTTPS ne pose aucune difficulté particulière : c’est du trafic web, votre proxy sait faire.
Le SSH, si — parce que le port 22 de la machine hôte est déjà occupé par le serveur SSH d’administration. Trois stratégies possibles, que nous détaillerons en 2.3 :
- Exposer le SSH de la forge sur un autre port (222, par exemple). Simple, mais l’URL de clonage devra le mentionner.
- Faire relayer par le serveur SSH de l’hôte, pour conserver le port 22 standard. Plus élégant, plus délicat à configurer.
- Ne pas activer SSH du tout et travailler exclusivement en HTTPS avec des jetons d’accès. Parfaitement viable, notamment derrière un proxy d’entreprise.
Il n’y a pas de bonne réponse universelle. Décidez en 2.3, mais sachez dès maintenant que cette question existe : la version initiale du compose que nous utiliserons a les ports SSH commentés, ce qui est cohérent avec la troisième stratégie.
La checklist avant de lancer
Sept décisions à prendre avant le premier docker compose up. Notez vos réponses quelque part : elles vous serviront tout au long de la section.
| # | Décision | Votre choix |
|---|---|---|
| 1 | Nom DNS définitif de la forge | forge.__________ |
| 2 | Certificat : autorité interne ou publique ? | |
| 3 | Base de données | PostgreSQL |
| 4 | Chemin des données sur l’hôte | /opt/__________ |
| 5 | UID/GID propriétaire des données | 1000 par défaut |
| 6 | Accès SSH : port dédié, relais, ou aucun | |
| 7 | Où et comment sera sauvegardé le dossier de données |
La septième ligne n’est pas de la coquetterie. Vous êtes en train de créer un service dont dépendront bientôt vos postes, vos serveurs et vos déploiements. Décider de sa sauvegarde après coup, c’est accepter de ne jamais la tester.
Nous y consacrerons deux leçons complètes en section 14 — mais choisissez dès maintenant un emplacement de données qui entre dans le périmètre de votre sauvegarde existante.
Ce qu’il faut retenir
- Forgejo est léger ; ce sont le runner et le registre qui dimensionnent la machine.
- Comptez 2 vCPU, 4 Go de RAM et 40 Go de disque pour aller au bout de la formation.
- Choisissez PostgreSQL dès le départ : la migration depuis SQLite se paie plus tard.
- Le disque est le poste qui grossit, à cause du registre d’images — prévoyez de pouvoir l’étendre.
- Deux emplacements à sauvegarder ensemble : les données de Forgejo et celles de la base.
- Le nom DNS se retrouvera dans vos GPO, vos scripts et vos fichiers Compose : choisissez-le définitivement.
- Décidez de votre stratégie de sauvegarde avant l’installation, pas après.
Dans la leçon suivante
Place au déploiement. Nous allons décortiquer un docker-compose.yml de production, ligne par ligne : les deux services, l’isolation réseau, les variables d’environnement de Forgejo et leur logique de nommage, les montages, et la gestion du mot de passe de la base.
Ce dernier point donnera lieu à un premier cas d’école : le fichier qui déploie votre forge est aussi le premier que vous ne devrez pas y pousser tel quel.