CYBBACK

    Sauvegarder GitLab.com ou GitLab auto-hébergé : ce qui change

    GitLab existe en service hébergé (GitLab.com) et en version installée chez vous (Self-Managed). Les outils de sauvegarde natifs ne sont pas les mêmes, et aucun ne vise la restauration d'un seul projet.

    Par Product Marketing CYBBACK2 min de lectureVérifié le 14/11/2026

    En auto-hébergé : la sauvegarde d'instance

    La commande de sauvegarde (Self-Managed uniquement) produit une archive qui contient notamment la base de données, les dépôts git et les objets LFS, les wikis, les fichiers téléversés et les données des registres.

    1. 1Sur une installation par paquet Linux, lancez : sudo gitlab-backup create.
    2. 2Sauvegardez à part le dossier de configuration, au minimum /etc/gitlab/gitlab-secrets.json et /etc/gitlab/gitlab.rb : ils ne sont pas dans l'archive.
    3. 3Sauvegardez le stockage objet par les moyens de votre fournisseur, s'il est utilisé : la commande ne le couvre pas.
    4. 4Conservez les clés et certificats TLS et SSH, également exclus.
    Ranger le fichier de secrets au même endroit que l'archive qu'il permet de déchiffrer annule l'intérêt du chiffrement, rappelle GitLab.

    Restaurer en auto-hébergé

    • Une sauvegarde ne se restaure que sur exactement la même version et le même type (CE ou EE) de GitLab.
    • La restauration ne sait pas restaurer un seul projet ou un seul groupe. GitLab propose de restaurer l'archive sur une instance temporaire de même version, d'y exporter le projet, puis de l'importer sur l'instance d'origine.
    • Sur de grosses instances, la commande peut devenir impraticable (24 heures ou plus) ; GitLab cite des stratégies alternatives, comme les sauvegardes incrémentales.

    Sur GitLab.com

    La commande de sauvegarde d'instance est réservée à l'auto-hébergé. Sur GitLab.com, les outils à disposition sont la suppression différée de 30 jours et l'export de projet, que GitLab déconseille comme sauvegarde. Voir export et import de projet et projet ou groupe supprimé.

    Ce qu'apporte une sauvegarde externe

    Une sauvegarde au niveau des projets se restaure projet par projet, sans instance temporaire, et fonctionne pareil sur les deux offres. CYBBACK se connecte à GitLab.com comme à une instance auto-hébergée, sauvegarde chaque projet en sous-tâche distincte et restaure un projet, une branche ou un ticket. Voir la solution GitLab.

    Questions fréquentes

    gitlab-backup sauvegarde-t-il la configuration ?

    Non. Les fichiers de configuration (/etc/gitlab), dont gitlab-secrets.json et gitlab.rb, doivent être sauvegardés à part, de même que les clés TLS et SSH.

    Peut-on restaurer un seul projet depuis une sauvegarde gitlab-backup ?

    Pas directement. GitLab propose de restaurer sur une instance temporaire de même version, d'exporter le projet, puis de l'importer.

    Aller plus loin

    Les outils natifs couvrent les erreurs récentes. Pour garder des versions datées au-delà, restaurables et stockées en Europe ou chez vous, découvrez la sauvegarde CYBBACK.

    Sources officielles

    Faits vérifiés le 14/11/2026 dans la documentation officielle de l'éditeur :

    Guide indépendant, non affilié à l'éditeur de GitHub et GitLab. Les noms cités sont des marques de leurs propriétaires. Les interfaces évoluent : en cas de doute, la documentation officielle fait foi.

    À lire aussi