Exporter un projet
Il faut le rôle Maintainer ou Owner du projet.
- 1Ouvrez le projet.
- 2Allez dans Settings, General.
- 3Dépliez Advanced.
- 4Sélectionnez Export project.
- 5Quand l'export est prêt, suivez le lien de l'e-mail reçu, ou actualisez la page et sélectionnez Download export.
Un traitement supprime ces fichiers d'export toutes les 24 heures : téléchargez-le rapidement.
Importer le fichier
Dans Create new, New project/repository, choisissez Import project, puis GitLab export, saisissez le nom et l'URL du projet, choisissez le fichier et validez avec Import project. Il faut le rôle Maintainer ou Owner sur le groupe de destination.
La version de destination doit être identique ou plus récente que la source, et au plus deux versions mineures d'écart sont prises en charge. Sur GitLab.com, le fichier importé fait 5 Go au plus.
Ce que l'export emporte, et ce qu'il laisse
| Exporté | Non exporté |
|---|---|
| Dépôt et wiki, fichiers téléversés, objets LFS | Variables CI/CD, déclencheurs de pipeline, variables des planifications |
| Tickets, merge requests, commentaires | Webhooks et intégrations |
| Étiquettes, jalons, extraits, releases, tableaux | Images des registres de packages et de conteneurs |
| Branches et tags protégés, règles de push | Journaux et artefacts des jobs |
| Membres directs du projet | Jetons chiffrés, fichiers sécurisés, politiques de sécurité |
Les limites
- GitLab l'écrit : il ne faut pas utiliser les fichiers d'export de projet pour sauvegarder ses données.
- Selon les cas, les contributions des autres utilisateurs peuvent être attribuées à la personne qui importe.
- Les liens entre tickets et vers les merge requests liées ne sont pas exportés.
- Par défaut, l'export est limité à 6 projets par minute, et le téléchargement à 1 par projet et par minute.
CYBBACK sauvegarde chaque nuit le code, le wiki, les tickets, les merge requests, les variables CI/CD avec leur valeur, les webhooks et les règles de protection, et restaure un projet ou un élément sans passer par un fichier d'export. Voir la solution GitLab.
Questions fréquentes
L'export de projet GitLab inclut-il les variables CI/CD ?
Non. Les variables CI/CD, les déclencheurs de pipeline et les variables des planifications ne sont pas exportés.
Peut-on utiliser l'export de projet comme sauvegarde ?
GitLab le déconseille explicitement : il ne faut pas utiliser les fichiers d'export de projet pour sauvegarder ses données.
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.