Comment installer Gitea pour avoir un serveur Git local

Information numérique » Ressources » Comment installer Gitea pour avoir un serveur Git local

Si vous en avez assez de dépendre des règles, des coûts ou de la disponibilité de géants comme GitHub ou GitLab, la solution est de créer votre propre infrastructure. Disposer d'un serveur Git chez vous ou au bureau vous offre un contrôle total sur votre code , une gestion complète des accès et la tranquillité d'esprit de ne pas subir les limitations de tiers sur vos dépôts privés.

Parmi toutes les options disponibles, Gitea se distingue comme une perle rare. Cet outil, écrit en Go, est incroyablement léger et rapide , idéal pour ceux qui ne souhaitent pas allouer 16 Go de RAM à un serveur Git. Contrairement à GitLab, véritable paquebot riche en fonctionnalités mais gourmand en ressources, Gitea est comme un hors-bord : il va droit au but, consomme très peu de ressources et offre une interface très familière à tous ceux qui ont déjà utilisé GitHub.

Comparaison rapide : Gitea, GitLab et Forgejo

Avant de vous lancer dans l'installation, il est important de bien comprendre les différentes options. GitLab est la solution d'entreprise par excellence, idéale pour les grandes équipes ayant besoin d'une intégration continue et continue (CI/CD), mais elle exige un matériel puissant. Gitea, quant à lui, est le meilleur choix pour les serveurs modestes ou les projets personnels grâce à sa très faible consommation de mémoire. Enfin, il y a Forgejo, une version communautaire de Gitea ; si vous êtes un fervent défenseur du logiciel libre et que vous préférez une gouvernance ouverte sans influence corporative, c'est l'alternative qu'il vous faut.

Ce dont vous avez besoin avant de commencer

Pour un fonctionnement optimal, assurez-vous de disposer d'un serveur Linux (Ubuntu, Debian ou Rocky Linux) avec accès root. L'installation de Git est également essentielle. Bien que Gitea permette l'utilisation de SQLite, PostgreSQL ou MariaDB sont fortement recommandés en environnement de production afin de garantir la stabilité des données.

Préparation du terrain dans le système

Pour des raisons de sécurité, il est déconseillé d'exécuter Gitea en tant que root. Il est préférable de créer un utilisateur dédié. Vous pouvez le faire en exécutant la commande suivante : adduser --system --shell /bin/bash --group --home /home/gitea giteaIl est essentiel d'utiliser /bin/bash en tant que shell Gitea doit interagir avec git-shell via SSH. Si Git n'est pas encore installé, une simple commande suffit. apt install git résoudra rapidement le problème.

Installation binaire et structure des dossiers

Gitea peut être installé de plusieurs manières, mais le fichier binaire est la méthode la plus simple. Vous devriez trouver la dernière version stable sur son site web officiel et la télécharger en utilisant [méthode/méthode]. wget en /usr/local/bin/giteale donner plus tard Exécuter les permissions avec chmod +xPour que le programme fonctionne correctement, une série de répertoires spécifiques doivent être créés : /etc/gitea pour la configuration et /var/lib/gitea pour les données, journaux et fichiers personnalisés. N'oubliez pas d'ajuster les autorisations de propriété (chown) afin que l'utilisateur gitea puisse leur écrire.

Configuration de la base de données

Si vous choisissez PostgreSQL, vous devrez installer le paquet et créer un rôle spécifique avec un mot de passe fort, en plus de la base de données. giteadb avec l'encodage UTF-8. Si vous préférez MariaDB, la procédure est similaire : vous créez la base de données et l'utilisateur, en veillant à ce que… Le moteur de stockage est InnoDB. et que le serveur écoute sur le port 3306.

Automatisation avec SystemD

Pour éviter de devoir démarrer Gitea manuellement à chaque redémarrage du serveur, il est préférable de créer un fichier de lecteur dans /etc/systemd/system/gitea.serviceCe fichier indique au système que Gitea doit être exécuté en tant que servicedéfinir l'utilisateur, le groupe et le chemin d'accès au binaire. Une fois créé, il suffit d'exécuter systemctl enable --now gitea et le serveur commencera à écouter, par défaut, sur le port 3000.

Le premier contact avec l'interface web

En entrant http://tu-ip:3000Vous accéderez ensuite à l'assistant de configuration. C'est ici que vous connecterez la base de données (en spécifiant l'hôte, le nom d'utilisateur et le mot de passe) et définirez les paramètres. paramètres généraux du site, comme le nom de l'instance et l'URL de base. Il est également temps de configurer le serveur SSH et de décider si vous souhaitez autoriser l'inscription à tous ou si vous préférez… désactiver la journalisation publique pour préserver la confidentialité du serveur.

Sécurité et accès professionnel avec Nginx

L'accès à Gitea via le port 3000 est inefficace et non sécurisé. La solution idéale consiste à configurer un proxy inverse avec Nginx . Cela permet aux utilisateurs d'accéder au site via un nom de domaine (par exemple, git.votre_domaine.com) et garantit le chiffrement de tout le trafic grâce aux certificats SSL Let's Encrypt . Dans la configuration Nginx, il suffit de rediriger le trafic du port 443 vers le port 3000 de Gitea, en ajoutant les en-têtes X-Forwarded-For pour éviter la perte de l'adresse IP réelle du client.

Gestion des utilisateurs et migration du code

Si vous avez désactivé la journalisation ouverte, vous pouvez créer le premier administrateur en utilisant la ligne de commande avec la commande gitea admin user createUne fois à l'intérieur, vous pouvez ajouter votre clés SSH publiques Dans le profil utilisateur, clonez des dépôts sans avoir à saisir votre mot de passe à chaque fois. Si vous avez déjà du code sur GitHub, Gitea propose une solution. outil de migration intégré Il importe automatiquement non seulement le code, mais aussi les problèmes et les étiquettes.

Entretien et réglage

La maintenance de Gitea est extrêmement simple. Pour mettre à jour, il suffit de télécharger le nouveau fichier binaire, de remplacer l'ancien et de redémarrer le service. Pour les sauvegardes, utilisez la commande gitea dump est votre meilleur ami, puisqu'il génère un fichier compressé contenant toutBase de données, configuration et dépôts. Pour la messagerie, vous pouvez configurer un serveur SMTP externe (tel que Gmail) ou installer Postfix sur le serveur pour recevoir les notifications de demandes d'extraction et les alertes.

La mise en œuvre de Gitea vous permet de disposer d'une plateforme de contrôle de version robuste, légère et entièrement privée, éliminant la dépendance aux services externes grâce à une installation binaire, une base de données optimisée et un proxy inverse qui garantit la sécurité du trafic via HTTPS.