# Installation Guide

Cloudback provides automated backups for your Linear workspace data, including issues, projects, documents, cycles, comments, labels, templates, and embedded files. This guide walks you through connecting your Linear workspace to Cloudback.

## Overview of the Setup Process

To start backing up your Linear workspace with Cloudback, you'll need to complete the following steps:

1. **Sign in to Cloudback** with your existing Linear account
2. **Add a Linear workspace** via the Cloudback dashboard
3. **Authorize Cloudback** through Linear's OAuth flow
4. **Verify configuration** and optionally customize backup settings

## Prerequisites

Before you begin, ensure you have:

* **A Linear workspace** - You must be an **admin** or **owner** of the Linear workspace you want to back up
* **An active subscription** - A Cloudback subscription plan that covers the workspace. You can purchase a plan via [GitHub Marketplace](https://github.com/marketplace/cloudback), [Azure Marketplace](https://azuremarketplace.microsoft.com/en-us/marketplace/apps/myrtlelabs-sas.cloudback), or by [contacting support](https://github.com/cloudback/docs-internal/blob/docs/troubleshooting-and-support/contact-us.md) for invoiced billing

> **Note**: Unlike GitHub and Azure DevOps, Linear does not have a marketplace integration. Subscriptions are managed via existing payment methods and assigned to your Linear workspace through the [Subscription Management](https://github.com/cloudback/docs-internal/blob/docs/account-and-billing-management/subscription-management.md) page.

## Step 1: Add a Linear Workspace

1. Sign in to the [Cloudback Dashboard](https://app.cloudback.it)
2. In the left sidebar under **Dashboard**, click **Add Account** (the `+` icon)
3. Select **Linear** from the platform options

## Step 2: Authorize Cloudback

Clicking "Linear" opens a popup window that guides you through two authorization steps. Both happen automatically in sequence - you only need to approve each one.

## Step 3: Workspace Connection

After both authorizations complete, Cloudback will:

1. Retrieve your workspace information (name, URL, logo)
2. Verify that you have **admin** or **owner** access to the workspace
3. Create the workspace backup definition with default settings

You'll see a success confirmation, and your Linear workspace will appear in the dashboard under the **Linear** section in the left sidebar.

## Step 4: Verify Configuration

After connecting your workspace, Cloudback applies the settings from your account. You can customize these settings by clicking on your workspace in the dashboard to open the **Workspace Details** page, then modifying the **Settings** section.

### Assign a Subscription

If you haven't already, assign a subscription to your Linear workspace:

1. Navigate to **Subscriptions** in the left sidebar
2. Click **View** on the subscription you want to use
3. In the **Account Assignments** section, select your Linear workspace from the dropdown
4. Click **Assign**

Once connected and a subscription is assigned:

* Your first backup will run according to the configured schedule (or you can trigger one manually by clicking **Backup now** on the workspace details page)
* Each backup creates an encrypted ZIP archive containing all workspace data
* You can monitor backup status, download archives, or restore data from the dashboard

## Multiple Workspaces

Each Linear workspace must be connected independently. To back up additional workspaces, repeat Steps 1-4 for each one. Each workspace connection requires a separate OAuth authorization - you may have different accounts or roles across workspaces.

All connected workspaces share units from the same subscription pool. See [Linear Pricing](https://docs.cloudback.it/linear/pricing) for how units are calculated across multiple workspaces.

## Setup Complete

Cloudback is now configured to protect your Linear workspace. Here's what to expect:

* **Backup Schedule**: Your first backup will commence according to the schedule you've set.
* **Dashboard Access**: Access your Cloudback Dashboard anytime at <https://app.cloudback.it>.
* **Service Status**: If you experience any issues, check our status page at <https://status.cloudback.it/>.
* **Support**: If you have any questions, don't hesitate to [contact support](https://github.com/cloudback/docs-internal/blob/docs/troubleshooting-and-support/contact-us.md).

## Learn More

* [Linear Backup Contents](https://docs.cloudback.it/linear/backup-contents) - What data is included in each backup
* [First Backup Walkthrough](https://docs.cloudback.it/linear/first-backup-walkthrough) - Step-by-step guide to your first backup
* [Subscription Management](https://github.com/cloudback/docs-internal/blob/docs/account-and-billing-management/subscription-management.md) - Assigning subscriptions to accounts
* [Dashboard Overview](https://github.com/cloudback/docs-internal/blob/docs/dashboard/dashboard-overview.md) - Navigating the Cloudback dashboard