# Bulk Restore

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](https://docs.cloudback.it/data-restoration/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

1. Go to the **Dashboard** in Cloudback.
2. Use the checkboxes to select the repositories/workspaces you want to restore.
3. Click the **Restore** button in the toolbar.

Only items with existing backups will be available for restoration.

![Trigger restore button](https://2781059148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQEI7SjBF2CddqNXZpCoE%2Fuploads%2Fgit-blob-6ebfaf252c2bb4fa9a723f142f30e76a35a3f209%2Fbackup-restore-from-dashboard.png?alt=media)

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.

![Review selected backups](https://2781059148-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQEI7SjBF2CddqNXZpCoE%2Fuploads%2Fgit-blob-ebc539f67a0d9a10d497f7b8c9d5650692945d42%2Fbulk-restore-select-backups.png?alt=media)

#### 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](https://docs.cloudback.it/restoring-a-backup#step-2-select-target) 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:

1. **Select Source**: Choose backups to restore (same as above)
2. **Select Platform**: Choose the target platform (GitHub or GitLab)
3. **Select Target**: Choose the target account/namespace
4. **Restoring**: Monitor progress

For details on how data is converted between platforms, see [Cross-Platform Restore](https://docs.cloudback.it/data-restoration/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](https://docs.cloudback.it/data-restoration/restoring-a-backup) guide for individual restores.

## Learn More

* [Restoring a Backup](https://docs.cloudback.it/data-restoration/restoring-a-backup)
* [GitHub: Restoring Data](https://docs.cloudback.it/github/restore)
* [Cross-Platform Restore](https://docs.cloudback.it/data-restoration/cross-platform-restore)
* [Repository Details](https://docs.cloudback.it/dashboard/repository-details)
* [Customer Managed Storages](https://docs.cloudback.it/storage-configuration/customer-managed-storages)