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.
- 1Sur une installation par paquet Linux, lancez : sudo gitlab-backup create.
- 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.
- 3Sauvegardez le stockage objet par les moyens de votre fournisseur, s'il est utilisé : la commande ne le couvre pas.
- 4Conservez les clés et certificats TLS et SSH, également exclus.
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 :
- GitLab Docs: Back up GitLab
- GitLab Docs: Restore GitLab
- GitLab Docs: Migrate GitLab data by using file exports
- GitLab Docs: Control access and visibility
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.