Back up and restore overview
- Tier: Free, Premium, Ultimate
- Offering: GitLab Self-Managed
Your GitLab instance contains critical data for your software development or organization. It is important to have a disaster recovery plan that includes regular backups for:
- Data protection: Safeguard against data loss due to hardware failures, software bugs, or accidental deletions.
- Disaster recovery: Restore GitLab instances and data in case of adverse events.
- Version control: Provide historical snapshots that enable rollbacks to previous states.
- Compliance: Meet the regulatory requirements of specific industries.
- Migration: Facilitate moving GitLab to new servers or environments.
- Testing and development: Create copies for testing upgrades or new features without risk to production data.
This documentation applies to GitLab Community and Enterprise Edition. While data security is ensured for GitLab.com, you can’t use these methods to export or back up your data from GitLab.com.
Back up GitLab
The procedures to back up your GitLab instance vary based on your deployment’s specific configuration and usage patterns. Factors such as data types, storage locations, and volume influence the backup method, storage options, and restoration process. For more information, see Back up GitLab.
Restore GitLab
The procedures to back up your GitLab instance vary based on your deployment’s specific configuration and usage patterns. Factors such as data types, storage locations, and volume influence the restoration process.
For more information, see Restore GitLab.
Migrate to a new server
Use the GitLab backup and restore features to migrate your instance to a new server. For GitLab Geo deployments, consider Geo disaster recovery for planned failover. For more information, see Migrate to a new server.
Back up and restore large reference architectures
It is important to back up and restore large reference architectures regularly. For information on how to configure and restore backups for object storage data, PostgreSQL data, and Git repositories, see Back up and restore large reference architectures.
Backup archive process
For data preservation and system integrity, GitLab creates a backup archive. For detailed information on how GitLab creates this archive, see Backup archive process.
Related topics
Docs
Edit this page to fix an error or add an improvement in a merge request.
Create an issue to suggest an improvement to this page.
Product
Create an issue if there's something you don't like about this feature.
Propose functionality by submitting a feature request.
Feature availability and product trials
View pricing to see all GitLab tiers and features, or to upgrade.
Try GitLab for free with access to all features for 30 days.
Get help
If you didn't find what you were looking for, search the docs.
If you want help with something specific and could use community support, post on the GitLab forum.
For problems setting up or using this feature (depending on your GitLab subscription).
Request support