Comment auto-héberger Forgejo sur un VPS (Guide complet)

Forgejo est un puissant service Git auto-hébergé open-source qui offre une expérience fluide pour gérer vos projets et dépôts. Le déployer sur un serveur privé virtuel (VPS) vous permet de garder le contrôle total sur vos données et de personnaliser votre environnement. Ce guide vous accompagne à travers les étapes nécessaires pour auto-héberger Forgejo sur un VPS, couvrant tout, de l’installation à la configuration.

Prérequis

Avant de commencer, assurez-vous d’avoir ce qui suit :

• Un VPS avec au moins 1 Go de RAM et 1 cœur CPU
• Un nom de domaine pointé vers votre VPS (facultatif mais recommandé)
• Docker et Docker Compose installés sur votre VPS
• Connaissances de base en ligne de commande Linux

Choisir un fournisseur de VPS

Lors de la sélection d’un fournisseur de VPS, prenez en compte des facteurs comme la performance, le prix et le support. Voici une comparaison de quelques fournisseurs de VPS parmi les meilleurs adaptés pour héberger Forgejo :

Tous les prix sont compétitifs et offrent une base solide pour l’auto-hébergement d’applications comme Forgejo. Consultez notre comparatif complet de VPS pour plus d’options.

Étape 1 : Configurer votre VPS

1. Accéder à votre VPS : Utilisez SSH pour vous connecter à votre VPS.

   ssh root@your_server_ip

2. Mettre à jour le système : Assurez-vous que votre VPS est à jour.

   apt update && apt upgrade -y

3. Installer Docker et Docker Compose :

   apt install docker.io docker-compose -y

4. Démarrer le service Docker :

   systemctl start docker
   systemctl enable docker

Étape 2 : Déployer Forgejo avec Docker

1. Créer un répertoire pour Forgejo :

   mkdir -p /opt/forgejo
   cd /opt/forgejo

2. Créer le fichier docker-compose.yml :

   Utilisez votre éditeur de texte préféré pour créer le fichier.

   nano docker-compose.yml

   Ajoutez le contenu suivant :

   version: '3'
   
   services:
     forgejo:
       image: forgejo/forgejo:latest
       environment:
         - GITEA__database__DB_TYPE=sqlite3
         - GITEA__database__PATH=/data/gitea/gitea.db
         - GITEA__server__DOMAIN=yourdomain.com
         - GITEA__server__ROOT_URL=https://yourdomain.com
       volumes:
         - ./data:/data
       ports:
         - "3000:3000"
         - "22:22"
       restart: unless-stopped

   Ajustez le DOMAIN et le ROOT_URL à votre nom de domaine réel.

3. Démarrer Forgejo :

   docker-compose up -d

Étape 3 : Accéder à Forgejo

Après le démarrage du conteneur, vous pouvez accéder à Forgejo en naviguant vers http://yourdomain.com:3000 dans votre navigateur. Complétez la configuration initiale, y compris la création d’un compte administrateur.

Optionnel : Configurer un proxy inverse

Pour une meilleure sécurité et un support SSL, il est recommandé de configurer un proxy inverse. Vous pouvez utiliser NGINX ou Traefik à cet effet. Voici un exemple simple de configuration NGINX :

1. Installer NGINX :

   apt install nginx -y

2. Créer la configuration NGINX :

   nano /etc/nginx/sites-available/forgejo

   Ajoutez ce qui suit :

   server {
       listen 80;
       server_name yourdomain.com;
   
       location / {
           proxy_pass http://localhost:3000;
           proxy_set_header Host $host;
           proxy_set_header X-Real-IP $remote_addr;
           proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
       }
   }

3. Activer la configuration :

   ln -s /etc/nginx/sites-available/forgejo /etc/nginx/sites-enabled/
   nginx -t
   systemctl restart nginx

FAQs

1. Quelle est la sécurité de l’auto-hébergement de Forgejo sur un VPS ?

L’auto-hébergement de Forgejo sur un VPS peut être sécurisé, à condition que vous suiviez les meilleures pratiques telles que la mise à jour régulière de vos logiciels, l’utilisation de mots de passe forts et la configuration de pare-feu. Assurez-vous que votre fournisseur de VPS offre une protection DDoS et choisissez un emplacement de centre de données qui correspond à vos besoins en matière de latence et de sécurité. De plus, sécurisez votre instance Forgejo avec HTTPS pour chiffrer les données en transit. Consultez les pratiques de sécurité décrites dans des forums comme r/selfhosted pour des recommandations plus détaillées.

2. Puis-je personnaliser les fonctionnalités de Forgejo ?

Oui, Forgejo est hautement personnalisable. Vous pouvez modifier ses paramètres via le panneau d’administration pour l’adapter à vos besoins. Forgejo prend en charge diverses méthodes d’authentification, permissions de dépôt et bien plus encore. Explorez la documentation officielle de Forgejo pour des instructions de personnalisation complètes et découvrez comment l’intégrer avec des outils CI/CD pour une productivité accrue.

3. Que faire si je rencontre des problèmes lors de l’installation ?

Si vous rencontrez des problèmes lors de l’installation ou de la configuration de Forgejo, envisagez de consulter des forums communautaires tels que r/selfhosted et les problèmes sur GitHub. De plus, assurez-vous que les versions de Docker et Docker Compose sont à jour, car la compatibilité peut parfois entraîner des problèmes. Le dépôt GitHub de Forgejo contient également des informations précieuses et un support utilisateur, ce qui en fait une ressource utile pour le dépannage.

En suivant ce guide, vous devriez maintenant avoir une instance Forgejo pleinement fonctionnelle exécutée sur votre VPS. Bon codage et auto-hébergement !