Comment auto-héberger Gitea sur DigitalOcean (Guide 2026)

Introduction

Gitea est un service Git léger auto-hébergé qui fournit une interface web pour gérer les dépôts Git. Configurer Gitea sur DigitalOcean peut être une excellente option pour les développeurs cherchant à contrôler leur flux de travail Git sans dépendre de services externes. Ce guide vous accompagnera tout au long du processus, de la mise en service d’un VPS à l’installation et à la configuration de Gitea.

Étape 1 : Provisionner un VPS DigitalOcean

Avant de pouvoir installer Gitea, vous devez provisionner un serveur privé virtuel (VPS) sur DigitalOcean. Voici une comparaison rapide des options de VPS adaptées pour héberger Gitea :

Lorsque vous choisissez un VPS, tenez compte de votre utilisation prévue et sélectionnez un plan qui correspond à vos besoins. Pour une installation basique de Gitea, l’option DigitalOcean à 6 $/mois est un choix fiable.

Provisionnez votre VPS en créant un compte sur DigitalOcean. Une fois connecté, créez un droplet en utilisant Ubuntu 20.04 (ou la dernière version LTS).

Étape 2 : Configurer votre VPS

Une fois votre VPS prêt, connectez-vous via SSH :

ssh root@<your_droplet_ip>

Mettre à jour votre système

Avant d’installer Gitea, assurez-vous que votre système est à jour :

sudo apt update && sudo apt upgrade -y

Installer les dépendances

Gitea nécessite Git, un serveur de base de données et quelques autres dépendances. Installez-les avec :

sudo apt install git sqlite3 -y

SQLite est une excellente base de données légère pour les petites installations.

Étape 3 : Installer Gitea

Télécharger Gitea

Vous devrez télécharger le dernier binaire de Gitea. Consultez les versions de Gitea sur GitHub pour la dernière version. Utilisez la commande ci-dessous pour le télécharger directement sur votre serveur :

wget -O gitea.gz https://dl.gitea.io/gitea/<version>/gitea-<version>-linux-amd64

Extrayez et déplacez le binaire vers /usr/local/bin :

sudo tar -xzvf gitea.gz
sudo mv gitea /usr/local/bin/
sudo chmod +x /usr/local/bin/gitea

Créer les répertoires nécessaires

Créez maintenant des répertoires pour que Gitea puisse stocker des fichiers :

sudo mkdir -p /var/lib/gitea/{custom,data,log}
sudo chown -R root:root /var/lib/gitea/

Créer un utilisateur Gitea

Créez un utilisateur dédié pour exécuter Gitea :

sudo adduser --disabled-login --gecos 'Gitea' gitea

Configurer Gitea

Créez un fichier de service pour gérer Gitea avec systemd :

sudo nano /etc/systemd/system/gitea.service

Ajoutez le contenu suivant :

[Unit]
Description=Gitea
After=network.target

[Service]
User=gitea
Group=gitea
WorkingDirectory=/var/lib/gitea
ExecStart=/usr/local/bin/gitea web
Restart=always
Environment=USER=gitea HOME=/var/lib/gitea GITEA_WORK_DIR=/var/lib/gitea

[Install]
WantedBy=multi-user.target

Démarrer Gitea

Activez et démarrez le service Gitea :

sudo systemctl enable gitea
sudo systemctl start gitea

Étape 4 : Configurer Gitea via l’interface web

Accédez à http://<your_droplet_ip>:3000 dans votre navigateur. Vous devriez voir la page de configuration de Gitea.

1. Paramètres de la base de données : Choisissez SQLite pour une configuration simple.
2. Compte Administrateur : Créez un compte pour gérer Gitea.
3. URL de l’application : Définissez l’URL de votre application (par exemple, http://<your_droplet_ip>:3000).

Une fois tous les champs complétés, cliquez sur le bouton “Installer Gitea” pour terminer la configuration.

FAQ

Qu’est-ce que Gitea et pourquoi devrais-je l’auto-héberger ?

Gitea est un service Git léger et auto-hébergé qui offre aux utilisateurs une interface simplifiée et personnalisable pour gérer les dépôts Git. En auto-hébergeant Gitea, vous avez un contrôle total sur vos données, évitez le verrouillage des fournisseurs et pouvez personnaliser votre installation selon vos besoins spécifiques. Cela est particulièrement avantageux pour les développeurs et les équipes qui valorisent la confidentialité et la sécurité ou qui gèrent leur propre cycle de vie de développement logiciel.

Combien coûte l’hébergement de Gitea sur DigitalOcean ?

L’hébergement de Gitea sur DigitalOcean commence à 6 $ par mois pour leur droplet basique, qui fournit 1 Go de RAM, 25 Go de stockage SSD et 1 vCPU. Cette configuration est suffisante pour les petites équipes ou les projets individuels. Cependant, les coûts peuvent augmenter si vous avez besoin de plus de ressources, en fonction des exigences de votre projet. N’oubliez pas de prendre en compte d’autres dépenses potentielles, telles que l’enregistrement de domaine et les sauvegardes.

Puis-je utiliser une autre base de données au lieu de SQLite pour Gitea ?

Oui, Gitea prend en charge plusieurs bases de données, y compris MySQL, PostgreSQL et MSSQL, en plus de SQLite. Bien que SQLite soit adapté pour les petites installations, des déploiements plus importants ou des environnements professionnels pourraient bénéficier de l’utilisation de MySQL ou PostgreSQL en raison de leur évolutivité et de leurs capacités de performance. Consultez la documentation de Gitea pour des instructions de configuration détaillées adaptées à votre base de données choisie.

Conclusion

Configurer Gitea sur DigitalOcean est un processus simple qui peut considérablement améliorer votre flux de travail de développement logiciel. Avec ce guide, vous pouvez maintenant gérer vos propres dépôts Git, en maintenant un contrôle et une personnalisation complets de votre environnement. Pour une compréhension plus large des options de VPS, consultez la comparaison complète des VPS.

Profitez de la communauté des auto-hébergeurs en explorant des ressources sur r/selfhosted ou en contribuant aux listes awesome-selfhosted. Bon codage !