Installation Guide

Step-by-step guide to installing and configuring Cloudback for Azure DevOps repository backups, including Azure Marketplace subscription and initial setup.

Cloudback provides secure, automated backups for your Azure DevOps repositories. This guide will walk you through the process of setting up Cloudback for your Azure DevOps organization.

Overview of the Setup Process

To start backing up your Azure DevOps repositories with Cloudback, you'll need to complete the following steps:

1. Sign Up / Log In to Cloudback

2. Connect your Azure DevOps organization

3. Purchase a Subscription from the Azure Marketplace

4. Verify Configuration and start protecting your repositories

Let's go through each step in detail.

1. Sign Up or Log In to Cloudback

1. Visit the Cloudback Dashboard.

2. Sign in with your preferred account (GitHub or Microsoft account).

3. Review and accept the Terms of Service and Privacy Policy if this is your first time.

2. Connect Your Azure DevOps Organization

After signing in, you'll need to connect your Azure DevOps organization to Cloudback:

1. From left navigation menu, click on "Add Account" button and then click Connect Azure DevOps.

2. You will be redirected to Microsoft's authorization page.

3. Sign in with your Microsoft account that has access to the Azure DevOps organization you want to protect.

4. Review the necessary permissions to access your Azure DevOps repositories, check Consent on behalf of your organisation and click Accept button.

Review required permissions

1. Set up the Cloudback Azure DevOps Backup Service Principal for your organization.

Configure Service Principal account

1. Click Refresh Projects to see the list of projects available to Service Principal user. Note, that it may take a few minutes for the Service Principal to be added in Azure DevOps organization.

2. Once you see all the projects you want to back up, click Add Projects. You will be redirected to Cloudback Dashboard.

Security Note: Cloudback uses read-only permissions for backup operations. Write permissions are only requested in a separate application when performing restore operations.

3. Purchase a Subscription from Azure Marketplace

Cloudback is available on the Microsoft Azure Marketplace, making setup and billing simple for Azure DevOps teams.

Benefits of Azure Marketplace Subscription

• Add Cloudback directly from your Azure account

• Use your existing Azure billing setup

• Consolidate Cloudback costs into your standard Azure billing cycle

• Simplify procurement and subscription management

How to Subscribe

1. Visit the Cloudback listing on Azure Marketplace.

2. Click "Get it now".

3. Choose your preferred plan based on the number of repositories you want to protect.

4. Select your Azure subscription and resource group, insert a SaaS subscription name.

5. Complete the purchase process by clicking Subscribe button.

6. Wait for Azure to configure your subscription, then click Configure Account now button.

7. You will be redirected to the Cloudback dashboard, where you will see the confirmation message: "Your Azure subscription has been successfully activated"

Azure Marketplace Subscription

Available Plans

• Per 10 repositories monthly plan: $10 per 10 repositories/month

• Per 100 repositories monthly plan: $75 per 100 repositories/month

• Per 1000 repositories monthly plan: $500 per 1000 repositories/month

You can purchase multiple units of each plan to increase coverage.

For alternative payment methods (credit card, bank transfer), see Payment Methods.

4. Verify Configuration

After connecting your organization and purchasing a subscription, you can verify your configuration:

1. Open the Cloudback Dashboard.

2. Navigate to your Azure DevOps dashboard.

3. You should see your repositories listed and ready for backup:

Azure DevOps Dashboard

Default Settings

Cloudback comes pre-configured with sensible defaults:

• Backup Schedule: Daily automated backups

• Storage: Cloudback Managed Storage

• Retention Policy: Last 30 days

• Notifications: Daily email notifications for failed backups

Customizing Your Configuration

You can customize various settings for your Azure DevOps backups:

• Backup Schedule: Choose from predefined schedules or set custom intervals

• Storage: Use Cloudback Managed Storage or configure your own (AWS S3, Azure Blob, Google Cloud, etc.)

• Retention Policy: Adjust how long backups are retained

• Notifications: Configure email notifications and instant alerts

For more details, see Account Settings.

Setup Complete

Congratulations! Cloudback is now configured to protect your Azure DevOps repositories. Here's what to expect:

• First Backup: Your first backup will run within 24 hours according to your schedule.

• Dashboard Access: Monitor all your backups at https://app.cloudback.it.

• Service Status: Check https://status.cloudback.it/ for any service updates.

What Gets Backed Up

Cloudback creates comprehensive backups of your Azure DevOps repositories, including full repository content, pull requests, and all associated metadata. For details, see Azure DevOps Backup Contents.

Learn More

• First Backup Walkthrough - Monitor your first backup

• Azure DevOps Backup Contents - What's included in backups

• Restoring a Repository - How to restore backups

• Connected Accounts - Managing organization access

Need help? Contact our support team.