> ## Documentation Index
> Fetch the complete documentation index at: https://help.onetsolutions.net/llms.txt
> Use this file to discover all available pages before exploring further.

# Installer GitLab

> Installer GitLab pour gérer vos dépôts Git en auto-hébergement

GitLab est une plateforme open source puissante pour gérer des dépôts Git, offrant le contrôle de version, le suivi de tickets et des fonctionnalités CI/CD.

<Info>
  **Prérequis**

  * Un VPS avec au moins 4 Go de RAM (8 Go recommandés)
  * Système d'exploitation Ubuntu ou Debian
  * Un nom de domaine pointant vers votre VPS (recommandé)
</Info>

## Étapes d'installation

<Steps>
  <Step title="Mettre à jour les paquets système">
    ```bash theme={null}
    sudo apt update
    ```
  </Step>

  <Step title="Installer les dépendances">
    ```bash theme={null}
    sudo apt install curl openssh-server ca-certificates postfix
    ```

    Lors de la configuration de postfix, sélectionnez « Internet Site » pour un usage général.
  </Step>

  <Step title="Ajouter le dépôt GitLab">
    ```bash theme={null}
    curl https://packages.gitlab.com/install/repositories/gitlab/gitlab-ee/script.deb.sh | sudo bash
    ```
  </Step>

  <Step title="Installer GitLab">
    ```bash theme={null}
    sudo apt install gitlab-ee
    ```
  </Step>

  <Step title="Configurer l'URL externe">
    Éditez le fichier de configuration GitLab :

    ```bash theme={null}
    sudo nano /etc/gitlab/gitlab.rb
    ```

    Trouvez et mettez à jour le paramètre `external_url` :

    ```ruby theme={null}
    external_url 'https://gitlab.yourdomain.com'
    ```
  </Step>

  <Step title="Reconfigurer GitLab">
    ```bash theme={null}
    sudo gitlab-ctl reconfigure
    ```

    Cette opération peut prendre plusieurs minutes.
  </Step>

  <Step title="Accéder à GitLab">
    Rendez-vous sur l'URL configurée. À la première visite, il vous sera demandé de configurer le compte administrateur.
  </Step>
</Steps>

## Après l'installation

<CardGroup cols={2}>
  <Card title="Mettre à jour GitLab" icon="arrows-rotate">
    Maintenez votre instance GitLab à jour :

    ```bash theme={null}
    sudo apt update
    sudo apt upgrade gitlab-ee
    sudo gitlab-ctl reconfigure
    ```
  </Card>

  <Card title="Sauvegarder GitLab" icon="cloud-arrow-up">
    Créez une sauvegarde de vos données GitLab :

    ```bash theme={null}
    sudo gitlab-backup create
    ```
  </Card>
</CardGroup>

<Warning>
  Planifiez des sauvegardes régulières pour éviter toute perte de données. Les sauvegardes GitLab incluent les dépôts, la base de données et les pièces jointes.
</Warning>

## Options de configuration

<AccordionGroup>
  <Accordion title="Activer HTTPS" icon="lock">
    GitLab peut obtenir automatiquement des certificats SSL via Let's Encrypt. Assurez-vous que votre `external_url` utilise `https://` puis exécutez `gitlab-ctl reconfigure`.
  </Accordion>

  <Accordion title="Configurer SMTP" icon="envelope">
    Éditez `/etc/gitlab/gitlab.rb` pour configurer l'envoi de notifications par e-mail via SMTP. Cela permet à GitLab d'envoyer des e-mails de notification.
  </Accordion>

  <Accordion title="Optimisation des ressources" icon="gauge">
    Sur un VPS à RAM limitée, vous pouvez réduire la consommation mémoire de GitLab en désactivant les fonctionnalités inutilisées dans `/etc/gitlab/gitlab.rb`.
  </Accordion>
</AccordionGroup>

<Tip>
  Pour des options de configuration détaillées, consultez la [documentation GitLab](https://docs.gitlab.com/).
</Tip>