Bulk Restore
Restore multiple items from backup in just a few clicks using Cloudback's Bulk Restore feature, with cross-platform support for GitHub and GitLab.
The Bulk Restore feature allows you to restore multiple repositories or workspaces at once, making disaster recovery and migration faster and easier. This guide walks you through the bulk restore process for all supported platforms. Cross-platform restore between GitHub and GitLab is also supported.
Overview
Bulk Restore simplifies the process of restoring multiple items from backup in just a few clicks. The feature uses a step-by-step wizard to guide you through selecting and restoring backups. To restore a single item, use the Restoring a Backup guide instead.
Important: All selected items must be from the same platform. If you select items from multiple platforms, the operation will be blocked with an error message asking you to select from a single platform. For Linear, all selected items must also be from the same workspace.
When to Use Bulk Restore
Restoring several repositories after data loss or corruption
Migrating repositories to a new account or organization
Migrating repositories from several accounts to a single account
Cross-platform migration between GitHub and GitLab
Testing recovery scenarios in staging or QA environments
How to Perform a Bulk Restore
Same-Platform Restore
Step 1: Select Source
Go to the Dashboard in Cloudback.
Use the checkboxes to select the repositories/workspaces you want to restore.
Click the Restore button in the toolbar.
Only items with existing backups will be available for restoration.
In the Bulk Restore wizard, review the list of selected items and their available backup dates. By default, the latest backup for each item is selected. You can change the backup snapshot for each item using the dropdown. Click Next to continue.
Step 2: Select Target
Enter the target location where the items will be restored. The target selection varies by platform - see the platform tabs in Restoring a Backup for details on each platform's target options.
Step 3: Restoration Progress
You will see a progress dashboard showing each item's restore status:
Succeeded - Restore completed successfully
In progress - Restore currently running
Queued - Restore is waiting to start
Failed - Restore encountered an error
You can safely close the progress window at any time; the restore operations continue in the background. Each restore is available for review in the Restores tab of the repository/workspace details page.
Cross-Platform Restore
For restoring between GitHub and GitLab, the wizard adds an additional platform selection step:
Select Source: Choose backups to restore (same as above)
Select Platform: Choose the target platform (GitHub or GitLab)
Select Target: Choose the target account/namespace
Restoring: Monitor progress
For details on how data is converted between platforms, see Cross-Platform Restore.
Troubleshooting
Restore failed? Click on the failed item in the progress list to view error details and recommended actions.
Not all repositories listed? Ensure you have the correct account selected and that backups exist for the desired items.
Need to restore to different accounts or projects? All selected items are restored to a single target location. For restoring to different accounts or projects, perform separate bulk restores.
Want to restore a single repository? Use the Restoring a Backup guide for individual restores.
Learn More
Last updated
Was this helpful?