Configurer GitLab sur un VPS

GitLab est une plateforme DevOps complète — hébergement de dépôts Git, pipelines CI/CD, suivi des tâches et collaboration d'équipe, le tout en un seul outil. Héberger votre propre instance sur un VPS signifie que vous gardez le contrôle total : votre code reste sur votre serveur, aucune limite sur les dépôts privés, et aucun tiers n'a accès à vos données. Pour les équipes qui travaillent sur des bases de code sensibles ou des projets internes, c'est une différence majeure par rapport à une instance cloud mutualisée.

GitLab est gourmand en ressources par nature. Assurez-vous que votre VPS dispose d'au moins 4 Go de RAM et 4 cœurs CPU avant de commencer — en dessous, vous risquez fort de rencontrer des problèmes de stabilité.

• Site officiel
• Documentation GitLab

Configurer votre domaine

GitLab a besoin d'un domaine pour obtenir automatiquement un certificat SSL via Let's Encrypt. Sans lui, la configuration ne se terminera pas correctement.

1. Enregistrez un domaine ou créez un sous-domaine — quelque chose comme git.votre-site.com convient parfaitement.
2. Rendez-vous dans la section de gestion DNS de votre panneau de contrôle et créez un enregistrement A pointant vers l'adresse IP de votre VPS.
3. Attendez la propagation DNS — cela prend généralement entre 5 et 30 minutes.

Se connecter au serveur

1. Connectez-vous à votre panneau de contrôle → VPS → sélectionnez votre serveur.
2. Récupérez l'adresse IP et le mot de passe root dans les détails de la commande.
3. Connectez-vous via SSH en spécifiant directement le port 2222 :

ssh root@VOTRE_IP_SERVEUR -p 2222

Connexion au serveur et configuration initiale de GitLab

Lancer l'assistant de configuration

À la première connexion, vous serez accueilli par l'écran de bienvenue de GitLab Direct Image :

*****************************************************
* GitLab Direct Image (SSL / Port 22 for Git)       *
*****************************************************
* EN: BEFORE RUNNING: Point A-record to this server IP
* EN: SYSTEM SSH PORT: 2222
* EN: To start setup, run: gitlab-setup
*****************************************************

L'assistant vous posera deux questions :

1. Domain — saisissez votre domaine (ex. git.example.com) :

Enter your domain (e.g., git.example.com):

2. Email — saisissez une adresse pour les notifications SSL de Let's Encrypt :

Enter Email for SSL notifications:

Ensuite, le script prend le relais et lance GitLab via Docker Compose. Vous verrez une sortie de ce type :

🐳 Starting GitLab via docker compose...
[+] up 2/2
 ✔ Network gitlab_default  Created   0.0s
 ✔ Container gitlab-web    Started   0.5s
------------------------------------------------
✅ Setup initiated!
⚠️  WARNING: System SSH is now on port 2222!
⏳ GitLab will be ready in 3-5 minutes.
🔑 Initial root password will be available at:
   cat /root/gitlab/config/initial_root_password
------------------------------------------------

Configuration de GitLab en cours

Récupérer le mot de passe administrateur

GitLab génère automatiquement un mot de passe temporaire pour le compte root. Récupérez-le avec la commande suivante :

cat /root/gitlab/config/initial_root_password

Copiez le mot de passe (le long code alphanumérique après le mot Password:) dans un endroit sûr — vous en aurez besoin dans un instant.

Récupération du mot de passe root initial de GitLab

Première connexion

Laissez GitLab 3 à 5 minutes pour démarrer complètement, puis ouvrez votre navigateur et accédez à :

https://votre-domaine.com

Écran de connexion GitLab

Connectez-vous avec :

• Nom d'utilisateur : root
• Mot de passe : celui récupéré à l'étape précédente

Une fois connecté, rendez-vous immédiatement dans User Settings → Password et définissez un mot de passe permanent avant toute autre action.

Changement du mot de passe dans GitLab

Gérer le service

GitLab tourne dans Docker, les commandes habituelles de docker compose s'appliquent donc. Naviguez d'abord dans le répertoire du projet :

cd /root/gitlab

Utilisez ensuite la commande dont vous avez besoin :

• Redémarrer : docker compose restart
• Arrêter : docker compose down
• Démarrer : docker compose up -d
• Suivre les logs : docker compose logs -f

Quelques points à garder en tête

• Séparation des ports SSH : le port 22 est réservé exclusivement aux opérations Git (git clone, git push, etc.). Pour vous connecter au serveur en SSH, utilisez toujours le port 2222.
• Redémarrage automatique : le conteneur Docker est configuré pour démarrer automatiquement au redémarrage du serveur — votre instance GitLab reviendra en ligne sans intervention manuelle.
• Ressources : surveillez l'utilisation de la mémoire, surtout à mesure que votre équipe et vos dépôts grandissent. Vous pouvez suivre la charge du serveur depuis le tableau de bord et changer de forfait si nécessaire.
• Sauvegardes : prenez l'habitude de sauvegarder vos dépôts et configurations. L'outil de sauvegarde intégré : docker exec -t gitlab-web gitlab-rake gitlab:backup:create.
  La sauvegarde est générée dans le conteneur Docker à /var/opt/gitlab/backups/. Pour copier le fichier dans votre répertoire hôte courant, exécutez :

docker cp gitlab-web:/var/opt/gitlab/backups/<backup_filename>.tar .