Restoring a Repository

Step-by-step guide to restoring your Cloudback repository backups to GitHub or Azure DevOps, including selecting source backups and target repositories.

Cloudback allows you to restore your backups to GitHub or Azure DevOps repositories. This page guides you through restoring a single repository backup. To restore multiple repositories at once, use the Bulk Restore feature.

Initiating a Restore

There are two ways to start a restore:

From the Repository Details Page

Open the Cloudback Dashboard and navigate to the repository details page. Open the Backups tab, find the backup you want to restore, and click the Restore icon:

Restore a backup from backups list

From the Dashboard Toolbar

On the Cloudback Dashboard, select the repository by checking the checkbox next to it, then click the Restore button in the toolbar:

Restore a backup from dashboard

Restore Permissions

Before restoring, Cloudback needs write access to create the new repository:

GitHub

The Cloudback Application has read-only access, following the principle of least privilege. For restores, install the Cloudback Restore Application which has read and write access. You can uninstall it after the restore is complete.

Azure DevOps

Restore Workflow

After clicking the Restore icon, a restore wizard will guide you through these steps:

1. Select Source: Choose the backup you want to restore.

2. Select Target: Choose where to restore the backup.

3. Restoring: Monitor the restoration progress.

Step 1: Select Backup

Choose the backup you want to restore from the list of available backups, then click Next:

Select a backup

Step 2: Select Target

Choose where to restore the backup and enter the new repository name:

GitHub

Select the target account, enter the new repository name, choose the repository visibility (public or private), and click Next.

Azure DevOps

Select repository for restore

Step 3: Restoring

The restore process starts and you can monitor the progress. You can wait for completion or return to the dashboard - the restore continues in the background. Once complete, you will see a notification with the restore status.

GitHub

The restoration includes source code, branches, tags, and all backed-up metadata (issues, pull requests, wiki, releases, labels, milestones, and more).

Azure DevOps

Viewing the Restored Repository

Once complete, view the restored repository by opening the repository details page, clicking the Restores tab, and clicking the repository link:

Open restored repository from restores list

Learn More

• Bulk Restore

• Cross-Account Restore

• Download Backups

• GitHub Backup Contents

• Azure DevOps Backup Contents