# Installation Guide

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](https://app.cloudback.it).
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 organization** and click the **Accept** button.
5. Set up the `Cloudback Azure DevOps Backup` Service Principal for your organization.
6. Click **Refresh Projects** to see the list of projects available to the Service Principal user. Note that it may take a few minutes for the Service Principal to be added in Azure DevOps organization.
7. 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](https://azuremarketplace.microsoft.com/en-us/marketplace/apps/myrtlelabs-sas.cloudback?tab=Overview).
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"

### 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](https://github.com/cloudback/docs-internal/blob/docs/account-and-billing-management/payment-methods.md).

## 4. Verify Configuration

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

1. Open the [Cloudback Dashboard](https://app.cloudback.it).
2. Navigate to your Azure DevOps dashboard.
3. You should see your repositories listed and ready for backup:

Cloudback applies sensible defaults (daily backups, managed storage, 30-day retention). You can customize all settings from the [Account Settings](https://github.com/cloudback/docs-internal/blob/docs/managing-backups/account-settings.md) page.

## 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 backs up your Azure DevOps repositories, including repository content, pull requests, and associated metadata. For details, see [Azure DevOps Backup Contents](https://docs.cloudback.it/azure-devops/backup-contents).

## Learn More

* [First Backup Walkthrough](https://docs.cloudback.it/azure-devops/first-backup-walkthrough) - Monitor your first backup
* [Azure DevOps Backup Contents](https://docs.cloudback.it/azure-devops/backup-contents) - What's included in backups
* [Restoring a Backup](https://github.com/cloudback/docs-internal/blob/docs/data-restoration/restoring-a-backup.md) - How to restore backups

Need help? [Contact support](https://github.com/cloudback/docs-internal/blob/docs/troubleshooting-and-support/contact-us.md).